home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Prog / A / Alpha.5.05.cpt / Help / Tickle < prev   
MacBinary  |  1992-08-31  |  34.8 KB  |  [TEXT/MSWD]
open in: MacOS 8.1     |     Win98     |     DOS

view JSON data     |     view as text

This file was processed as: MacBinary (archive/macBinary).

You can browse this item here: Tickle

ConfidenceProgramDetectionMatch TypeSupport
10% dexvert MacBinary (archive/macBinary) fallback Supported
10% dexvert Jesper Olsen Module (music/jesperOlsen) magic Supported
1% dexvert Text File (text/txt) fallback Supported
100% file MacBinary II, inited, Mon Aug 31 08:38:06 1992, modified Mon Aug 31 08:38:06 1992, creator Microsoft Word, type ASCII, 34862 bytes "Tickle" , at 0x88ae 484 bytes resource default (weak)
99% file data default
49% TrID Macintosh plain text (MacBinary) default
33% TrID TTComp archive compressed (bin-4K) default (weak)
16% TrID MacBinary 2 default (weak)
100% siegfried fmt/1762 MacBinary (II) default
100% lsar MacBinary default


id metadata
keyvalue
macFileType[TEXT]
macFileCreator[MSWD]


hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 06 54 69 63 6b 6c 65 | 00 00 00 00 00 00 00 00 |..Tickle|........|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 4d 53 57 | 44 01 00 00 00 00 00 00 |.TEXTMSW|D.......|
|00000050| 00 00 00 00 00 88 2e 00 | 00 01 e4 a6 c7 c3 2e a6 |........|........|
|00000060| c7 c3 2e 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 6c b6 00 00 |........|....l...|
|00000080| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.       |        |
|00000090| 20 20 20 20 20 74 69 63 | 6b 6c 65 0d 20 20 20 20 |     tic|kle.    |
|000000a0| 20 20 20 20 20 20 20 41 | 73 73 65 6d 62 6c 65 64 |       A|ssembled|
|000000b0| 20 61 6e 64 20 57 72 69 | 74 74 65 6e 20 42 79 0d | and Wri|tten By.|
|000000c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000000d0| 20 20 54 69 6d 20 45 6e | 64 72 65 73 0d 0d 20 20 |  Tim En|dres..  |
|000000e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 41 70 |        |      Ap|
|000000f0| 72 69 6c 20 32 2c 20 31 | 39 39 32 0d 20 20 20 20 |ril 2, 1|992.    |
|00000100| 20 20 20 20 20 20 20 20 | 20 20 20 20 52 65 6c 65 |        |    Rele|
|00000110| 61 73 65 20 33 2e 31 76 | 34 0d 0d 20 20 20 20 20 |ase 3.1v|4..     |
|00000120| 20 20 20 20 49 6e 74 65 | 72 6e 65 74 3a 20 20 20 |    Inte|rnet:   |
|00000130| 20 20 20 20 20 20 74 69 | 6d 65 40 69 63 65 2e 63 |      ti|me@ice.c|
|00000140| 6f 6d 0d 20 20 20 20 20 | 20 20 20 20 55 55 43 50 |om.     |    UUCP|
|00000150| 3a 20 20 20 20 20 20 20 | 20 20 20 68 65 69 66 65 |:       |   heife|
|00000160| 74 7a 21 74 62 6f 6d 62 | 21 74 69 6d 65 0d 20 20 |tz!tbomb|!time.  |
|00000170| 20 20 20 20 20 20 20 41 | 70 70 6c 65 4c 69 6e 6b |       A|ppleLink|
|00000180| 3a 20 20 20 74 69 6d 65 | 40 69 63 65 2e 63 6f 6d |:   time|@ice.com|
|00000190| 40 49 4e 54 45 52 4e 45 | 54 23 0d 20 20 20 20 20 |@INTERNE|T#.     |
|000001a0| 20 20 20 20 43 6f 6d 70 | 75 53 65 72 76 65 3a 20 |    Comp|uServe: |
|000001b0| 20 3e 49 4e 54 45 52 4e | 45 54 3a 74 69 6d 65 40 | >INTERN|ET:time@|
|000001c0| 69 63 65 2e 63 6f 6d 0d | 0d 0d 54 68 69 73 20 73 |ice.com.|..This s|
|000001d0| 6f 66 74 77 61 72 65 20 | 69 73 20 74 68 65 20 72 |oftware |is the r|
|000001e0| 65 73 75 6c 74 20 6f 66 | 20 61 20 6e 65 74 77 6f |esult of| a netwo|
|000001f0| 72 6b 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 63 |rk progr|amming c|
|00000200| 6f 6d 6d 75 6e 69 74 79 | 20 70 72 6f 70 65 6c 6c |ommunity| propell|
|00000210| 65 64 20 0d 62 79 20 73 | 6f 66 74 77 61 72 65 20 |ed .by s|oftware |
|00000220| 73 68 61 72 69 6e 67 2c | 20 61 6c 6c 6f 77 69 6e |sharing,| allowin|
|00000230| 67 20 77 6f 72 6b 20 74 | 6f 20 62 65 20 62 75 69 |g work t|o be bui|
|00000240| 6c 74 20 75 70 6f 6e 20 | 6f 74 68 65 72 73 27 20 |lt upon |others' |
|00000250| 77 6f 72 6b 20 0d 65 6c | 69 6d 69 6e 61 74 69 6e |work .el|iminatin|
|00000260| 67 20 72 65 64 75 6e 64 | 61 6e 63 79 20 61 6e 64 |g redund|ancy and|
|00000270| 20 61 6c 6c 6f 77 69 6e | 67 20 63 6f 6e 74 69 6e | allowin|g contin|
|00000280| 75 61 6c 20 69 6e 63 72 | 65 6d 65 6e 74 61 6c 20 |ual incr|emental |
|00000290| 0d 65 6e 68 61 6e 63 65 | 6d 65 6e 74 2e 0d 0d 50 |.enhance|ment...P|
|000002a0| 6c 65 61 73 65 20 67 69 | 76 65 20 74 69 63 6b 6c |lease gi|ve tickl|
|000002b0| 65 20 74 6f 20 61 6e 79 | 6f 6e 65 20 79 6f 75 20 |e to any|one you |
|000002c0| 77 69 73 68 2c 20 62 75 | 74 20 70 6c 65 61 73 65 |wish, bu|t please|
|000002d0| 20 67 69 76 65 20 74 68 | 65 6d 20 74 68 65 20 65 | give th|em the e|
|000002e0| 6e 74 69 72 65 20 0d 70 | 61 63 6b 61 67 65 20 73 |ntire .p|ackage s|
|000002f0| 6f 20 74 68 61 74 20 74 | 68 65 79 20 68 61 76 65 |o that t|hey have|
|00000300| 20 74 68 65 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 | the doc|umentati|
|00000310| 6f 6e 20 61 6e 64 20 72 | 65 66 65 72 65 6e 63 65 |on and r|eference|
|00000320| 73 2e 0d 0d 49 66 20 79 | 6f 75 20 68 61 76 65 20 |s...If y|ou have |
|00000330| 61 6e 79 20 71 75 65 73 | 74 69 6f 6e 73 2c 20 73 |any ques|tions, s|
|00000340| 75 67 67 65 73 74 69 6f | 6e 73 2c 20 6f 72 20 6a |uggestio|ns, or j|
|00000350| 75 73 74 20 68 61 76 65 | 20 73 6f 6d 65 20 63 6f |ust have| some co|
|00000360| 6d 70 65 6c 6c 69 6e 67 | 20 6e 65 65 64 20 0d 74 |mpelling| need .t|
|00000370| 6f 20 73 65 6e 64 20 65 | 6d 61 69 6c 2c 20 70 6c |o send e|mail, pl|
|00000380| 65 61 73 65 20 61 64 64 | 72 65 73 73 20 69 74 20 |ease add|ress it |
|00000390| 74 6f 20 74 69 63 6b 6c | 65 40 69 63 65 2e 63 6f |to tickl|e@ice.co|
|000003a0| 6d 2e 0d 0d 0d 2a 2a 2a | 20 57 68 61 74 20 69 73 |m....***| What is|
|000003b0| 20 54 69 63 6b 6c 65 3f | 20 2a 2a 2a 0d 0d 54 69 | Tickle?| ***..Ti|
|000003c0| 63 6b 6c 65 20 69 73 20 | 61 20 67 6c 6f 6d 20 6f |ckle is |a glom o|
|000003d0| 66 20 69 74 65 6d 73 20 | 74 68 61 74 20 77 65 72 |f items |that wer|
|000003e0| 65 20 61 73 73 65 6d 62 | 6c 65 64 20 6f 76 65 72 |e assemb|led over|
|000003f0| 20 61 20 6c 6f 6e 67 20 | 70 65 72 69 6f 64 20 6f | a long |period o|
|00000400| 66 20 74 69 6d 65 2e 20 | 0d 53 6f 6d 65 20 77 61 |f time. |.Some wa|
|00000410| 73 20 6d 79 20 6f 77 6e | 20 69 6e 73 61 6e 69 74 |s my own| insanit|
|00000420| 79 20 61 6e 64 20 6f 74 | 68 65 72 73 20 63 61 6d |y and ot|hers cam|
|00000430| 65 20 66 72 6f 6d 20 74 | 68 65 20 6e 65 74 2e 20 |e from t|he net. |
|00000440| 46 69 6e 61 6c 6c 79 2c | 20 74 68 65 20 6e 69 63 |Finally,| the nic|
|00000450| 65 20 0d 6c 69 74 74 6c | 65 20 74 63 6c 20 6c 61 |e .littl|e tcl la|
|00000460| 6e 67 75 61 67 65 20 63 | 61 6d 65 20 75 70 20 61 |nguage c|ame up a|
|00000470| 74 20 55 53 45 4e 49 58 | 2c 20 73 65 76 65 72 61 |t USENIX|, severa|
|00000480| 6c 20 70 65 6f 70 6c 65 | 20 6d 6f 61 6e 65 64 20 |l people| moaned |
|00000490| 61 62 6f 75 74 20 0d 77 | 61 6e 74 69 6e 67 20 69 |about .w|anting i|
|000004a0| 74 20 6f 6e 20 74 68 65 | 20 4d 61 63 2c 20 61 6e |t on the| Mac, an|
|000004b0| 64 20 69 74 20 73 65 65 | 6d 65 64 20 72 65 61 73 |d it see|med reas|
|000004c0| 6f 6e 61 62 6c 65 2e 0d | 0d 59 6f 75 20 77 69 6c |onable..|.You wil|
|000004d0| 6c 20 66 69 6e 64 20 74 | 68 61 74 20 74 69 63 6b |l find t|hat tick|
|000004e0| 6c 65 20 69 73 20 61 6e | 20 69 6e 76 61 6c 75 61 |le is an| invalua|
|000004f0| 62 6c 65 20 74 6f 6f 6c | 20 69 6e 20 64 65 61 6c |ble tool| in deal|
|00000500| 69 6e 67 20 77 69 74 68 | 20 74 68 65 20 76 61 72 |ing with| the var|
|00000510| 69 6f 75 73 20 0d 64 61 | 74 61 20 66 6f 72 6d 61 |ious .da|ta forma|
|00000520| 74 73 20 66 6c 79 69 6e | 67 20 61 72 6f 75 6e 64 |ts flyin|g around|
|00000530| 20 6f 6e 20 55 53 45 4e | 45 54 20 61 73 20 77 65 | on USEN|ET as we|
|00000540| 6c 6c 20 61 73 20 66 6f | 72 20 76 61 72 69 6f 75 |ll as fo|r variou|
|00000550| 73 20 4d 61 63 69 6e 74 | 6f 73 68 20 0d 66 69 6c |s Macint|osh .fil|
|00000560| 65 20 66 6f 72 6d 61 74 | 73 2e 20 59 6f 75 20 77 |e format|s. You w|
|00000570| 69 6c 6c 20 66 69 6e 64 | 20 42 69 6e 48 65 78 2c |ill find| BinHex,|
|00000580| 20 4d 61 63 42 69 6e 61 | 72 79 2c 20 41 70 70 6c | MacBina|ry, Appl|
|00000590| 65 20 53 69 6e 67 6c 65 | 2f 44 6f 75 62 6c 65 2c |e Single|/Double,|
|000005a0| 20 54 61 72 2c 20 0d 43 | 6f 6d 70 72 65 73 73 2c | Tar, .C|ompress,|
|000005b0| 20 75 75 65 6e 63 6f 64 | 65 2c 20 61 6e 64 20 73 | uuencod|e, and s|
|000005c0| 65 76 65 72 61 6c 20 54 | 45 58 54 20 66 69 6c 65 |everal T|EXT file|
|000005d0| 20 63 6f 6e 76 65 72 73 | 69 6f 6e 20 75 74 69 6c | convers|ion util|
|000005e0| 69 74 69 65 73 2e 0d 0d | 54 68 65 20 61 64 64 65 |ities...|The adde|
|000005f0| 64 20 62 6f 6e 75 73 20 | 6f 66 20 74 63 6c 20 61 |d bonus |of tcl a|
|00000600| 6c 6c 6f 77 73 20 66 6f | 72 20 74 68 65 20 61 75 |llows fo|r the au|
|00000610| 74 6f 6d 61 74 69 6f 6e | 20 6f 66 20 73 6f 6d 65 |tomation| of some|
|00000620| 20 6f 66 20 79 6f 75 72 | 20 74 61 73 6b 73 2c 20 | of your| tasks, |
|00000630| 61 73 20 0d 74 68 65 20 | 74 63 6c 20 6c 61 6e 67 |as .the |tcl lang|
|00000640| 75 61 67 65 20 68 61 73 | 20 62 65 65 6e 20 65 78 |uage has| been ex|
|00000650| 74 65 6e 64 65 64 20 74 | 6f 20 73 75 70 70 6f 72 |tended t|o suppor|
|00000660| 74 20 74 68 65 20 66 69 | 6c 65 20 75 74 69 6c 69 |t the fi|le utili|
|00000670| 74 69 65 73 20 6f 66 20 | 74 68 65 20 0d 61 70 70 |ties of |the .app|
|00000680| 6c 69 63 61 74 69 6f 6e | 2c 20 61 73 20 77 65 6c |lication|, as wel|
|00000690| 6c 20 61 73 20 61 6c 6c | 6f 77 69 6e 67 20 66 6f |l as all|owing fo|
|000006a0| 72 20 66 75 72 74 68 65 | 72 20 65 78 74 65 6e 73 |r furthe|r extens|
|000006b0| 69 6f 6e 73 20 62 79 20 | 74 68 65 20 75 73 65 72 |ions by |the user|
|000006c0| 20 76 69 61 20 0d 65 78 | 74 65 72 6e 61 6c 20 63 | via .ex|ternal c|
|000006d0| 6f 6d 6d 61 6e 64 73 20 | 61 6c 61 20 48 79 70 65 |ommands |ala Hype|
|000006e0| 72 43 61 72 64 20 58 43 | 4d 44 73 2e 20 53 75 70 |rCard XC|MDs. Sup|
|000006f0| 70 6f 72 74 20 6f 66 20 | 48 79 70 65 72 43 61 72 |port of |HyperCar|
|00000700| 64 20 58 43 4d 44 73 20 | 0d 69 73 20 62 65 69 6e |d XCMDs |.is bein|
|00000710| 67 20 69 6e 76 65 73 74 | 69 67 61 74 65 64 20 66 |g invest|igated f|
|00000720| 6f 72 20 61 20 66 75 74 | 75 72 65 20 72 65 6c 65 |or a fut|ure rele|
|00000730| 61 73 65 2e 0d 0d 0d 2a | 2a 2a 20 57 68 61 74 20 |ase....*|** What |
|00000740| 69 73 20 54 43 4c 3f 20 | 2a 2a 2a 0d 0d 59 6f 75 |is TCL? |***..You|
|00000750| 20 73 68 6f 75 6c 64 20 | 72 65 66 65 72 20 74 6f | should |refer to|
|00000760| 20 74 68 65 20 76 61 72 | 69 6f 75 73 20 69 6e 63 | the var|ious inc|
|00000770| 6c 75 64 65 64 20 6d 61 | 6e 20 70 61 67 65 73 20 |luded ma|n pages |
|00000780| 61 6e 64 20 70 61 70 65 | 72 73 20 73 75 62 6d 69 |and pape|rs submi|
|00000790| 74 74 65 64 20 0d 74 6f | 20 55 53 45 4e 49 58 20 |tted .to| USENIX |
|000007a0| 66 6f 72 20 64 65 74 61 | 69 6c 73 20 61 62 6f 75 |for deta|ils abou|
|000007b0| 74 20 74 63 6c 2e 20 42 | 72 69 65 66 6c 79 2c 20 |t tcl. B|riefly, |
|000007c0| 74 63 6c 20 69 73 20 61 | 20 73 69 6d 70 6c 65 20 |tcl is a| simple |
|000007d0| 73 74 72 69 6e 67 20 62 | 61 73 65 64 20 0d 73 63 |string b|ased .sc|
|000007e0| 72 69 70 74 69 6e 67 20 | 6c 61 6e 67 75 61 67 65 |ripting |language|
|000007f0| 20 64 65 73 69 67 6e 65 | 64 20 74 6f 20 62 65 20 | designe|d to be |
|00000800| 69 6e 63 6c 75 64 65 64 | 20 69 6e 20 73 74 61 6e |included| in stan|
|00000810| 64 61 72 64 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |dard app|lication|
|00000820| 73 2e 20 49 74 20 77 69 | 6c 6c 20 0d 61 6c 6c 6f |s. It wi|ll .allo|
|00000830| 77 20 79 6f 75 20 74 6f | 20 70 65 72 66 6f 72 6d |w you to| perform|
|00000840| 20 6d 61 6e 79 20 74 61 | 73 6b 73 20 74 68 61 74 | many ta|sks that|
|00000850| 20 61 72 65 20 6f 74 68 | 65 72 77 69 73 65 20 76 | are oth|erwise v|
|00000860| 65 72 79 20 6c 61 62 6f | 72 20 69 6e 74 65 6e 73 |ery labo|r intens|
|00000870| 69 76 65 2e 0d 0d 54 43 | 4c 20 77 61 73 20 63 72 |ive...TC|L was cr|
|00000880| 65 61 74 65 64 20 62 79 | 20 61 20 73 6d 61 6c 6c |eated by| a small|
|00000890| 20 73 65 74 20 6f 66 20 | 76 65 72 79 20 62 72 69 | set of |very bri|
|000008a0| 67 68 74 20 65 6e 67 69 | 6e 65 65 72 73 2c 20 6e |ght engi|neers, n|
|000008b0| 61 6d 65 6c 79 2c 20 4a | 6f 68 6e 20 0d 4f 75 73 |amely, J|ohn .Ous|
|000008c0| 74 65 72 68 6f 75 74 20 | 61 6e 64 20 68 69 73 20 |terhout |and his |
|000008d0| 67 72 61 64 75 61 74 65 | 20 73 74 75 64 65 6e 74 |graduate| student|
|000008e0| 73 2e 20 54 68 65 20 55 | 6e 69 78 20 65 78 74 65 |s. The U|nix exte|
|000008f0| 6e 73 69 6f 6e 73 20 77 | 65 72 65 20 69 6e 76 65 |nsions w|ere inve|
|00000900| 6e 74 65 64 20 0d 61 6e | 64 20 69 6d 70 6c 65 6d |nted .an|d implem|
|00000910| 65 6e 74 65 64 20 62 79 | 20 4b 61 72 6c 20 4c 65 |ented by| Karl Le|
|00000920| 68 65 6e 62 61 75 65 72 | 2c 20 4d 61 72 6b 20 44 |henbauer|, Mark D|
|00000930| 69 65 6b 68 61 6e 73 20 | 61 6e 64 20 50 65 74 65 |iekhans |and Pete|
|00000940| 72 20 64 61 20 53 69 6c | 76 61 20 0d 77 69 74 68 |r da Sil|va .with|
|00000950| 20 68 65 6c 70 20 66 72 | 6f 6d 20 4a 6f 72 64 61 | help fr|om Jorda|
|00000960| 6e 20 48 65 6e 64 65 72 | 73 6f 6e 2e 20 54 43 4c |n Hender|son. TCL|
|00000970| 20 77 61 73 20 73 69 6d | 70 6c 79 20 70 6f 72 74 | was sim|ply port|
|00000980| 65 64 20 69 6e 74 6f 20 | 74 69 63 6b 6c 65 20 62 |ed into |tickle b|
|00000990| 79 20 0d 54 69 6d 20 45 | 6e 64 72 65 73 2e 20 52 |y .Tim E|ndres. R|
|000009a0| 65 66 65 72 20 74 6f 20 | 74 68 65 20 69 6e 63 6c |efer to |the incl|
|000009b0| 75 64 65 64 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 |uded doc|umentati|
|000009c0| 6f 6e 20 66 6f 72 20 66 | 75 72 74 68 65 72 20 64 |on for f|urther d|
|000009d0| 65 74 61 69 6c 73 2e 0d | 0d 54 69 63 6b 6c 65 20 |etails..|.Tickle |
|000009e0| 63 6f 6d 65 73 20 77 69 | 74 68 20 74 68 65 20 6c |comes wi|th the l|
|000009f0| 69 62 72 61 72 69 65 73 | 20 66 6f 72 20 74 68 65 |ibraries| for the|
|00000a00| 20 74 63 6c 20 69 6e 74 | 65 72 70 72 65 74 65 72 | tcl int|erpreter|
|00000a10| 20 69 6e 63 6c 75 64 65 | 64 20 69 6e 20 74 69 63 | include|d in tic|
|00000a20| 6b 6c 65 2c 20 73 6f 20 | 0d 74 68 61 74 20 79 6f |kle, so |.that yo|
|00000a30| 75 20 6d 61 79 20 69 6e | 63 6f 72 70 6f 72 61 74 |u may in|corporat|
|00000a40| 65 20 74 68 65 6d 20 69 | 6e 74 6f 20 79 6f 75 72 |e them i|nto your|
|00000a50| 20 77 6f 72 6b 20 28 61 | 73 73 75 6d 69 6e 67 20 | work (a|ssuming |
|00000a60| 79 6f 75 20 68 61 76 65 | 20 4d 50 57 29 2e 20 0d |you have| MPW). .|
|00000a70| 4f 74 68 65 72 77 69 73 | 65 2c 20 79 6f 75 20 6d |Otherwis|e, you m|
|00000a80| 61 79 20 72 65 74 72 69 | 65 76 65 20 74 68 65 20 |ay retri|eve the |
|00000a90| 73 6f 75 72 63 65 73 20 | 66 6f 72 20 74 68 65 20 |sources |for the |
|00000aa0| 74 63 6c 20 69 6e 74 65 | 72 70 72 65 74 65 72 20 |tcl inte|rpreter |
|00000ab0| 66 72 6f 6d 20 49 43 45 | 2e 20 0d 54 68 65 20 63 |from ICE|. .The c|
|00000ac0| 68 61 6e 67 65 73 20 61 | 72 65 20 73 69 67 6e 69 |hanges a|re signi|
|00000ad0| 66 69 63 61 6e 74 2c 20 | 62 75 74 20 62 61 73 65 |ficant, |but base|
|00000ae0| 64 20 6f 6e 20 72 65 6c | 65 61 73 65 20 34 2e 30 |d on rel|ease 4.0|
|00000af0| 2e 20 48 6f 70 65 66 75 | 6c 6c 79 2c 20 77 65 20 |. Hopefu|lly, we |
|00000b00| 63 61 6e 20 0d 73 6f 6d | 65 68 6f 77 20 67 65 74 |can .som|ehow get|
|00000b10| 20 74 68 65 73 65 20 6d | 6f 64 69 66 69 63 61 74 | these m|odificat|
|00000b20| 69 6f 6e 73 20 70 75 74 | 20 69 6e 74 6f 20 74 68 |ions put| into th|
|00000b30| 65 20 67 65 6e 65 72 61 | 6c 20 74 63 6c 20 72 65 |e genera|l tcl re|
|00000b40| 6c 65 61 73 65 2c 20 62 | 75 74 20 69 6e 20 74 68 |lease, b|ut in th|
|00000b50| 65 20 0d 6d 65 61 6e 74 | 69 6d 65 2c 20 70 65 6f |e .meant|ime, peo|
|00000b60| 70 6c 65 20 63 61 6e 20 | 75 73 65 20 61 74 20 6c |ple can |use at l|
|00000b70| 65 61 73 74 20 74 63 6c | 2e 20 54 68 65 20 72 65 |east tcl|. The re|
|00000b80| 6c 65 61 73 65 20 73 65 | 65 6d 73 20 76 65 72 79 |lease se|ems very|
|00000b90| 20 73 74 61 62 6c 65 2e | 0d 0d 54 6f 20 6f 70 65 | stable.|..To ope|
|00000ba0| 6e 20 61 20 74 63 6c 20 | 73 63 72 69 70 74 20 77 |n a tcl |script w|
|00000bb0| 69 6e 64 6f 77 2c 20 68 | 6f 6c 64 20 64 6f 77 6e |indow, h|old down|
|00000bc0| 20 74 68 65 20 53 68 69 | 66 74 20 6b 65 79 20 77 | the Shi|ft key w|
|00000bd0| 68 65 6e 20 79 6f 75 20 | 63 6c 69 63 6b 20 6f 6e |hen you |click on|
|00000be0| 20 74 68 65 20 0d 46 69 | 6c 65 20 6d 65 6e 75 2c | the .Fi|le menu,|
|00000bf0| 20 6f 72 20 77 68 65 6e | 20 79 6f 75 20 75 73 65 | or when| you use|
|00000c00| 20 43 6d 64 2d 4e 20 6f | 72 20 43 6d 64 2d 4f 2e | Cmd-N o|r Cmd-O.|
|00000c10| 20 49 6e 20 73 63 72 69 | 70 74 20 77 69 6e 64 6f | In scri|pt windo|
|00000c20| 77 73 20 79 6f 75 20 63 | 61 6e 20 0d 65 78 65 63 |ws you c|an .exec|
|00000c30| 75 74 65 20 61 6e 79 20 | 76 61 6c 69 64 20 74 63 |ute any |valid tc|
|00000c40| 6c 20 63 6f 64 65 20 62 | 79 20 73 65 6c 65 63 74 |l code b|y select|
|00000c50| 69 6e 67 20 74 68 65 20 | 74 65 78 74 20 61 6e 64 |ing the |text and|
|00000c60| 20 70 72 65 73 73 69 6e | 67 20 74 68 65 20 45 6e | pressin|g the En|
|00000c70| 74 65 72 20 6b 65 79 20 | 28 6f 72 20 0d 41 70 70 |ter key |(or .App|
|00000c80| 6c 65 2d 52 65 74 75 72 | 6e 2c 20 6f 72 20 74 68 |le-Retur|n, or th|
|00000c90| 65 20 79 69 6e 2d 79 61 | 6e 67 20 69 63 6f 6e 20 |e yin-ya|ng icon |
|00000ca0| 6e 65 78 74 20 74 6f 20 | 74 68 65 20 68 6f 72 69 |next to |the hori|
|00000cb0| 7a 6f 6e 74 61 6c 20 73 | 63 72 6f 6c 6c 20 62 61 |zontal s|croll ba|
|00000cc0| 72 29 2e 0d 0d 2a 2a 2a | 20 54 43 4c 20 45 78 74 |r)...***| TCL Ext|
|00000cd0| 65 6e 73 69 6f 6e 73 20 | 2a 2a 2a 0d 0d 54 6f 20 |ensions |***..To |
|00000ce0| 6d 61 6b 65 20 74 68 65 | 20 74 63 6c 20 69 6e 74 |make the| tcl int|
|00000cf0| 65 72 70 72 65 74 65 72 | 20 65 76 65 6e 20 6d 6f |erpreter| even mo|
|00000d00| 72 65 20 76 65 72 73 61 | 74 69 6c 65 2c 20 74 69 |re versa|tile, ti|
|00000d10| 63 6b 6c 65 20 67 69 76 | 65 73 20 79 6f 75 20 61 |ckle giv|es you a|
|00000d20| 20 74 65 78 74 20 0d 77 | 69 6e 64 6f 77 20 69 6e | text .w|indow in|
|00000d30| 20 77 68 69 63 68 20 79 | 6f 75 20 63 61 6e 20 74 | which y|ou can t|
|00000d40| 79 70 65 20 74 63 6c 20 | 73 63 72 69 70 74 73 2c |ype tcl |scripts,|
|00000d50| 20 61 6e 64 20 65 78 65 | 63 75 74 65 20 74 63 6c | and exe|cute tcl|
|00000d60| 20 63 6f 64 65 20 62 79 | 20 73 69 6d 70 6c 79 20 | code by| simply |
|00000d70| 0d 73 65 6c 65 63 74 69 | 6e 67 20 74 65 78 74 20 |.selecti|ng text |
|00000d80| 61 6e 64 20 70 72 65 73 | 73 69 6e 67 20 74 68 65 |and pres|sing the|
|00000d90| 20 45 6e 74 65 72 20 6b | 65 79 21 21 20 54 68 69 | Enter k|ey!! Thi|
|00000da0| 73 20 77 69 6c 6c 20 70 | 72 6f 76 69 64 65 20 79 |s will p|rovide y|
|00000db0| 6f 75 20 77 69 74 68 20 | 61 20 76 65 72 79 20 0d |ou with |a very .|
|00000dc0| 70 6f 77 65 72 66 75 6c | 20 65 6e 76 69 72 6f 6e |powerful| environ|
|00000dd0| 6d 65 6e 74 20 69 6e 20 | 77 68 69 63 68 20 74 6f |ment in |which to|
|00000de0| 20 65 78 70 65 72 69 6d | 65 6e 74 20 77 69 74 68 | experim|ent with|
|00000df0| 20 74 63 6c 2e 20 59 6f | 75 20 77 69 6c 6c 20 66 | tcl. Yo|u will f|
|00000e00| 69 6e 64 20 74 68 65 20 | 0d 69 6e 74 65 72 66 61 |ind the |.interfa|
|00000e10| 63 65 20 74 6f 20 62 65 | 20 76 65 72 79 20 6d 75 |ce to be| very mu|
|00000e20| 63 68 20 6c 69 6b 65 20 | 4d 50 57 2e 0d 0d 46 75 |ch like |MPW...Fu|
|00000e30| 72 74 68 65 72 2c 20 74 | 68 65 20 74 63 6c 20 6c |rther, t|he tcl l|
|00000e40| 61 6e 67 75 61 67 65 20 | 68 61 73 20 62 65 65 6e |anguage |has been|
|00000e50| 20 65 78 74 65 6e 64 65 | 64 20 74 6f 20 61 6c 6c | extende|d to all|
|00000e60| 6f 77 20 79 6f 75 20 74 | 6f 20 77 72 69 74 65 20 |ow you t|o write |
|00000e70| 65 78 74 65 72 6e 61 6c | 20 0d 63 6f 64 65 20 72 |external| .code r|
|00000e80| 65 73 6f 75 72 63 65 73 | 20 28 74 79 70 65 20 27 |esources| (type '|
|00000e90| 58 54 43 4c 27 29 20 74 | 68 61 74 20 61 72 65 20 |XTCL') t|hat are |
|00000ea0| 76 65 72 79 20 73 69 6d | 69 6c 61 72 20 69 6e 20 |very sim|ilar in |
|00000eb0| 6d 65 63 68 61 6e 69 73 | 6d 20 74 6f 20 0d 48 79 |mechanis|m to .Hy|
|00000ec0| 70 65 72 43 61 72 64 27 | 73 20 58 43 4d 44 73 2e |perCard'|s XCMDs.|
|00000ed0| 20 54 68 69 73 20 77 69 | 6c 6c 20 61 6c 6c 6f 77 | This wi|ll allow|
|00000ee0| 20 79 6f 75 20 74 6f 20 | 65 78 74 65 6e 64 20 74 | you to |extend t|
|00000ef0| 68 65 20 74 63 6c 20 6c | 61 6e 67 75 61 67 65 20 |he tcl l|anguage |
|00000f00| 0d 77 69 74 68 6f 75 74 | 20 64 65 61 6c 69 6e 67 |.without| dealing|
|00000f10| 20 77 69 74 68 20 74 68 | 65 20 74 63 6c 20 73 6f | with th|e tcl so|
|00000f20| 75 72 63 65 73 2c 20 6f | 72 20 72 65 62 75 69 6c |urces, o|r rebuil|
|00000f30| 64 69 6e 67 20 74 68 65 | 20 74 69 63 6b 6c 65 20 |ding the| tickle |
|00000f40| 61 70 70 6c 69 63 61 74 | 69 6f 6e 2e 0d 0d 0d 2a |applicat|ion....*|
|00000f50| 2a 2a 20 54 69 63 6b 6c | 65 20 54 43 4c 20 49 6e |** Tickl|e TCL In|
|00000f60| 74 65 72 70 72 65 74 65 | 72 73 20 2a 2a 2a 0d 0d |terprete|rs ***..|
|00000f70| 41 6e 79 74 69 6d 65 20 | 74 68 61 74 20 79 6f 75 |Anytime |that you|
|00000f80| 20 6f 70 65 6e 20 61 20 | 54 65 78 74 20 57 69 6e | open a |Text Win|
|00000f90| 64 6f 77 20 69 6e 20 74 | 69 63 6b 6c 65 2c 20 79 |dow in t|ickle, y|
|00000fa0| 6f 75 20 68 61 76 65 20 | 69 6e 73 74 61 6e 74 69 |ou have |instanti|
|00000fb0| 61 74 65 64 20 61 20 74 | 63 6c 20 0d 69 6e 74 65 |ated a t|cl .inte|
|00000fc0| 72 70 72 65 74 65 72 2e | 20 59 6f 75 20 6d 61 79 |rpreter.| You may|
|00000fd0| 20 74 72 65 61 74 20 74 | 68 65 20 77 69 6e 64 6f | treat t|he windo|
|00000fe0| 77 20 61 73 20 61 20 74 | 65 78 74 20 65 64 69 74 |w as a t|ext edit|
|00000ff0| 6f 72 2c 20 6f 72 20 61 | 73 20 61 20 74 63 6c 20 |or, or a|s a tcl |
|00001000| 73 68 65 6c 6c 2e 20 49 | 74 20 0d 62 65 63 6f 6d |shell. I|t .becom|
|00001010| 65 73 20 61 20 73 68 65 | 6c 6c 20 77 68 65 6e 20 |es a she|ll when |
|00001020| 79 6f 75 20 70 72 65 73 | 73 20 74 68 65 20 45 6e |you pres|s the En|
|00001030| 74 65 72 20 6b 65 79 20 | 74 6f 20 65 78 65 63 75 |ter key |to execu|
|00001040| 74 65 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 6c |te the c|urrent l|
|00001050| 69 6e 65 20 6f 72 20 0d | 73 65 6c 65 63 74 69 6f |ine or .|selectio|
|00001060| 6e 2e 0d 0d 45 61 63 68 | 20 74 65 78 74 20 77 69 |n...Each| text wi|
|00001070| 6e 64 6f 77 20 67 65 74 | 73 20 69 74 73 20 6f 77 |ndow get|s its ow|
|00001080| 6e 20 69 6e 73 74 61 6e | 74 69 61 74 69 6f 6e 20 |n instan|tiation |
|00001090| 6f 66 20 61 20 74 63 6c | 20 69 6e 74 65 72 70 72 |of a tcl| interpr|
|000010a0| 65 74 65 72 2e 20 54 68 | 69 73 20 6d 65 61 6e 73 |eter. Th|is means|
|000010b0| 20 0d 74 68 61 74 20 61 | 20 63 6f 6d 6d 61 6e 64 | .that a| command|
|000010c0| 20 64 65 66 69 6e 65 64 | 20 69 6e 20 6f 6e 65 20 | defined| in one |
|000010d0| 74 65 78 74 20 77 69 6e | 64 6f 77 20 77 69 6c 6c |text win|dow will|
|000010e0| 20 6e 6f 74 20 62 65 20 | 61 76 61 69 6c 61 62 6c | not be |availabl|
|000010f0| 65 20 69 6e 20 61 6e 6f | 74 68 65 72 20 0d 74 65 |e in ano|ther .te|
|00001100| 78 74 20 77 69 6e 64 6f | 77 27 73 20 69 6e 74 65 |xt windo|w's inte|
|00001110| 72 70 72 65 74 65 72 2e | 20 54 68 69 73 20 61 6c |rpreter.| This al|
|00001120| 73 6f 20 6d 65 61 6e 73 | 20 74 68 61 74 20 61 20 |so means| that a |
|00001130| 70 72 6f 63 65 64 75 72 | 65 20 6d 61 79 20 68 61 |procedur|e may ha|
|00001140| 76 65 20 74 77 6f 20 0d | 64 69 66 66 65 72 65 6e |ve two .|differen|
|00001150| 74 20 6d 65 61 6e 69 6e | 67 73 20 69 6e 20 74 77 |t meanin|gs in tw|
|00001160| 6f 20 64 69 66 66 65 72 | 65 6e 74 20 77 69 6e 64 |o differ|ent wind|
|00001170| 6f 77 73 2c 20 77 69 74 | 68 6f 75 74 20 61 20 63 |ows, wit|hout a c|
|00001180| 6f 6e 66 6c 69 63 74 2e | 0d 0d 48 6f 77 65 76 65 |onflict.|..Howeve|
|00001190| 72 2c 20 74 68 65 72 65 | 20 61 72 65 20 74 69 6d |r, there| are tim|
|000011a0| 65 73 20 77 68 65 6e 20 | 74 69 63 6b 6c 65 20 6e |es when |tickle n|
|000011b0| 65 65 64 73 20 74 6f 20 | 68 61 76 65 20 61 20 74 |eeds to |have a t|
|000011c0| 63 6c 20 69 6e 74 65 72 | 70 72 65 74 65 72 20 0d |cl inter|preter .|
|000011d0| 61 76 61 69 6c 61 62 6c | 65 2c 20 65 76 65 6e 20 |availabl|e, even |
|000011e0| 69 66 20 74 68 65 72 65 | 20 69 73 20 6e 6f 20 74 |if there| is no t|
|000011f0| 65 78 74 20 77 69 6e 64 | 6f 77 20 6f 70 65 6e 2e |ext wind|ow open.|
|00001200| 20 46 6f 72 20 69 6e 73 | 74 61 6e 63 65 2c 20 69 | For ins|tance, i|
|00001210| 66 20 61 20 44 6f 53 63 | 72 69 70 74 20 0d 41 70 |f a DoSc|ript .Ap|
|00001220| 70 6c 65 20 45 76 65 6e | 74 20 63 6f 6d 65 73 20 |ple Even|t comes |
|00001230| 69 6e 74 6f 20 74 69 63 | 6b 6c 65 2c 20 69 74 20 |into tic|kle, it |
|00001240| 77 69 6c 6c 20 6e 65 65 | 64 20 61 6e 20 69 6e 74 |will nee|d an int|
|00001250| 65 72 70 72 65 74 65 72 | 20 74 6f 20 65 78 65 63 |erpreter| to exec|
|00001260| 75 74 65 20 74 68 65 20 | 0d 73 63 72 69 70 74 2e |ute the |.script.|
|00001270| 20 54 6f 20 68 61 6e 64 | 6c 65 20 74 68 65 73 65 | To hand|le these|
|00001280| 20 73 69 74 75 61 74 69 | 6f 6e 73 2c 20 74 69 63 | situati|ons, tic|
|00001290| 6b 6c 65 20 63 72 65 61 | 74 65 73 20 61 20 67 6c |kle crea|tes a gl|
|000012a0| 6f 62 61 6c 20 69 6e 74 | 65 72 70 72 65 74 65 72 |obal int|erpreter|
|000012b0| 2e 20 54 68 69 73 20 0d | 69 6e 74 65 72 70 72 65 |. This .|interpre|
|000012c0| 74 65 72 20 69 73 20 63 | 72 65 61 74 65 64 20 61 |ter is c|reated a|
|000012d0| 74 20 73 74 61 72 74 75 | 70 20 6f 66 20 74 69 63 |t startu|p of tic|
|000012e0| 6b 6c 65 2c 20 61 6e 64 | 20 6c 69 76 65 73 20 75 |kle, and| lives u|
|000012f0| 6e 74 69 6c 20 74 69 63 | 6b 6c 65 20 69 73 20 71 |ntil tic|kle is q|
|00001300| 75 69 74 2e 20 54 68 65 | 20 0d 67 6c 6f 62 61 6c |uit. The| .global|
|00001310| 20 69 6e 74 65 72 70 72 | 65 74 65 72 20 69 73 20 | interpr|eter is |
|00001320| 77 68 65 72 65 20 41 70 | 70 6c 65 20 45 76 65 6e |where Ap|ple Even|
|00001330| 74 20 73 63 72 69 70 74 | 73 20 61 72 65 20 65 78 |t script|s are ex|
|00001340| 65 63 75 74 65 64 2c 20 | 61 6e 64 20 77 68 65 72 |ecuted, |and wher|
|00001350| 65 20 0d 46 69 6e 64 65 | 72 20 64 72 6f 70 70 65 |e .Finde|r droppe|
|00001360| 64 20 74 63 6c 20 73 63 | 72 69 70 74 73 20 61 72 |d tcl sc|ripts ar|
|00001370| 65 20 65 78 65 63 75 74 | 65 64 2c 20 61 6e 64 20 |e execut|ed, and |
|00001380| 77 68 65 72 65 20 74 68 | 65 20 74 69 63 6b 6c 65 |where th|e tickle|
|00001390| 20 43 52 4f 4e 20 0d 65 | 78 70 72 65 73 73 69 6f | CRON .e|xpressio|
|000013a0| 6e 20 69 73 20 65 78 65 | 63 75 74 65 64 2e 0d 0d |n is exe|cuted...|
|000013b0| 59 6f 75 20 6d 61 79 20 | 63 61 75 73 65 20 61 20 |You may |cause a |
|000013c0| 74 65 78 74 20 77 69 6e | 64 6f 77 20 74 6f 20 75 |text win|dow to u|
|000013d0| 73 65 20 74 68 65 20 67 | 6c 6f 62 61 6c 20 69 6e |se the g|lobal in|
|000013e0| 74 65 72 70 72 65 74 65 | 72 2c 20 69 6e 73 74 65 |terprete|r, inste|
|000013f0| 61 64 20 6f 66 20 61 20 | 0d 70 72 69 76 61 74 65 |ad of a |.private|
|00001400| 20 69 6e 74 65 72 70 72 | 65 74 65 72 2c 20 62 79 | interpr|eter, by|
|00001410| 20 68 6f 6c 64 69 6e 67 | 20 64 6f 77 6e 20 74 68 | holding| down th|
|00001420| 65 20 53 68 69 66 74 20 | 6b 65 79 20 77 68 65 6e |e Shift |key when|
|00001430| 20 6f 70 65 6e 69 6e 67 | 20 74 68 65 20 74 65 78 | opening| the tex|
|00001440| 74 20 0d 77 69 6e 64 6f | 77 2e 20 54 65 78 74 20 |t .windo|w. Text |
|00001450| 77 69 6e 64 6f 77 73 20 | 75 73 69 6e 67 20 74 68 |windows |using th|
|00001460| 65 20 67 6c 6f 62 61 6c | 20 69 6e 74 65 72 70 72 |e global| interpr|
|00001470| 65 74 65 72 20 77 69 6c | 6c 20 68 61 76 65 20 74 |eter wil|l have t|
|00001480| 68 65 20 77 6f 72 64 20 | 0d 47 6c 6f 62 61 6c 20 |he word |.Global |
|00001490| 64 69 73 70 6c 61 79 65 | 64 20 69 6e 20 74 68 65 |displaye|d in the|
|000014a0| 69 72 20 6c 6f 77 65 72 | 20 6c 65 66 74 20 63 6f |ir lower| left co|
|000014b0| 72 6e 65 72 2c 20 69 6e | 73 74 65 61 64 20 6f 66 |rner, in|stead of|
|000014c0| 20 4c 6f 63 61 6c 2e 0d | 0d 41 6c 73 6f 20 6e 6f | Local..|.Also no|
|000014d0| 74 65 20 74 68 61 74 20 | 74 68 65 20 73 63 72 69 |te that |the scri|
|000014e0| 70 74 20 a5 74 63 6c 69 | 6e 69 74 20 77 69 6c 6c |pt .tcli|nit will|
|000014f0| 20 62 65 20 65 78 65 63 | 75 74 65 64 20 77 69 74 | be exec|uted wit|
|00001500| 68 69 6e 20 74 68 65 20 | 63 6f 6e 74 65 78 74 20 |hin the |context |
|00001510| 6f 66 20 74 68 65 20 0d | 67 6c 6f 62 61 6c 20 69 |of the .|global i|
|00001520| 6e 74 65 72 70 72 65 74 | 65 72 20 61 74 20 74 69 |nterpret|er at ti|
|00001530| 63 6b 6c 65 20 73 74 61 | 72 74 75 70 20 74 69 6d |ckle sta|rtup tim|
|00001540| 65 2e 20 54 68 69 73 20 | 70 72 6f 76 69 64 65 73 |e. This |provides|
|00001550| 20 61 6e 20 6f 70 70 6f | 72 74 75 6e 69 74 79 20 | an oppo|rtunity |
|00001560| 74 6f 20 0d 65 73 74 61 | 62 6c 69 73 68 20 74 68 |to .esta|blish th|
|00001570| 65 20 67 6c 6f 62 61 6c | 20 69 6e 74 65 72 70 72 |e global| interpr|
|00001580| 65 74 65 72 20 66 6f 72 | 20 63 6f 6d 6d 6f 6e 6c |eter for| commonl|
|00001590| 79 20 75 73 65 64 20 65 | 78 74 65 6e 73 69 6f 6e |y used e|xtension|
|000015a0| 73 20 61 6e 64 20 66 6f | 72 20 0d 43 52 4f 4e 20 |s and fo|r .CRON |
|000015b0| 74 79 70 65 20 74 61 73 | 6b 73 2e 0d 53 70 65 63 |type tas|ks..Spec|
|000015c0| 69 66 69 63 20 54 43 4c | 20 45 78 74 65 6e 73 69 |ific TCL| Extensi|
|000015d0| 6f 6e 73 0d 0d 54 68 65 | 20 66 6f 6c 6c 6f 77 69 |ons..The| followi|
|000015e0| 6e 67 20 63 6f 6d 6d 61 | 6e 64 73 20 68 61 76 65 |ng comma|nds have|
|000015f0| 20 62 65 65 6e 20 61 64 | 64 65 64 20 74 6f 20 74 | been ad|ded to t|
|00001600| 68 65 20 73 74 61 6e 64 | 61 72 64 20 74 63 6c 20 |he stand|ard tcl |
|00001610| 63 6f 6d 6d 61 6e 64 20 | 73 65 74 20 0d 66 6f 72 |command |set .for|
|00001620| 20 74 68 65 20 74 69 63 | 6b 6c 65 20 61 70 70 6c | the tic|kle appl|
|00001630| 69 63 61 74 69 6f 6e 2e | 20 54 68 65 20 63 6f 6d |ication.| The com|
|00001640| 6d 61 6e 64 73 20 61 72 | 65 20 6d 6f 73 74 6c 79 |mands ar|e mostly|
|00001650| 20 4d 61 63 69 6e 74 6f | 73 68 20 73 70 65 63 69 | Macinto|sh speci|
|00001660| 66 69 63 2e 20 0d 46 75 | 72 74 68 65 72 2c 20 63 |fic. .Fu|rther, c|
|00001670| 6f 6d 6d 61 6e 64 73 20 | 61 72 65 20 70 72 6f 76 |ommands |are prov|
|00001680| 69 64 65 64 20 74 6f 20 | 61 6c 6c 6f 77 20 79 6f |ided to |allow yo|
|00001690| 75 20 74 6f 20 75 74 69 | 6c 69 7a 65 20 74 68 65 |u to uti|lize the|
|000016a0| 20 66 69 6c 65 20 75 74 | 69 6c 69 74 69 65 73 20 | file ut|ilities |
|000016b0| 62 75 69 6c 74 20 0d 69 | 6e 74 6f 20 74 69 63 6b |built .i|nto tick|
|000016c0| 6c 65 2e 0d 0d 61 6c 65 | 72 74 6e 6f 74 65 20 6d |le...ale|rtnote m|
|000016d0| 65 73 73 61 67 65 5f 73 | 74 72 69 6e 67 0d 20 20 |essage_s|tring.  |
|000016e0| 54 68 69 73 20 63 6f 6d | 6d 61 6e 64 20 77 69 6c |This com|mand wil|
|000016f0| 6c 20 64 69 73 70 6c 61 | 79 20 6d 65 73 73 61 67 |l displa|y messag|
|00001700| 65 5f 73 74 72 69 6e 67 | 20 69 6e 20 61 20 73 74 |e_string| in a st|
|00001710| 61 6e 64 61 72 64 20 4d | 61 63 69 6e 74 6f 73 68 |andard M|acintosh|
|00001720| 20 61 6c 65 72 74 20 62 | 6f 78 2e 0d 0d 63 64 20 | alert b|ox...cd |
|00001730| 64 69 72 65 63 74 6f 72 | 79 0d 20 20 54 68 69 73 |director|y.  This|
|00001740| 20 63 6f 6d 6d 61 6e 64 | 20 77 69 6c 6c 20 73 65 | command| will se|
|00001750| 74 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 77 6f |t the cu|rrent wo|
|00001760| 72 6b 69 6e 67 20 64 69 | 72 65 63 74 6f 72 79 20 |rking di|rectory |
|00001770| 74 6f 20 64 69 72 65 63 | 74 6f 72 79 2e 20 54 68 |to direc|tory. Th|
|00001780| 65 20 64 69 72 65 63 74 | 6f 72 79 20 0d 20 20 61 |e direct|ory .  a|
|00001790| 72 67 75 6d 65 6e 74 20 | 6d 61 79 20 6f 72 20 6d |rgument |may or m|
|000017a0| 61 79 20 6e 6f 74 20 65 | 6e 64 20 77 69 74 68 20 |ay not e|nd with |
|000017b0| 61 20 63 6f 6c 6f 6e 2e | 20 54 68 65 20 77 6f 72 |a colon.| The wor|
|000017c0| 6b 69 6e 67 20 64 69 72 | 65 63 74 6f 72 79 20 69 |king dir|ectory i|
|000017d0| 73 20 74 68 65 20 64 69 | 72 65 63 74 6f 72 79 20 |s the di|rectory |
|000017e0| 0d 20 20 69 6e 20 77 68 | 69 63 68 20 66 69 6c 65 |.  in wh|ich file|
|000017f0| 20 6e 61 6d 65 73 20 74 | 68 61 74 20 63 6f 6e 74 | names t|hat cont|
|00001800| 61 69 6e 20 6e 6f 20 63 | 6f 6c 6f 6e 73 20 28 66 |ain no c|olons (f|
|00001810| 6f 6c 64 65 72 73 29 20 | 77 69 6c 6c 20 62 65 20 |olders) |will be |
|00001820| 6c 6f 63 61 74 65 64 20 | 77 69 74 68 20 66 69 6c |located |with fil|
|00001830| 65 20 72 65 6c 61 74 65 | 64 20 0d 20 20 63 6f 6d |e relate|d .  com|
|00001840| 6d 61 6e 64 73 2e 0d 0d | 70 77 64 0d 20 20 54 68 |mands...|pwd.  Th|
|00001850| 69 73 20 63 6f 6d 6d 61 | 6e 64 20 77 69 6c 6c 20 |is comma|nd will |
|00001860| 72 65 74 75 72 6e 20 74 | 68 65 20 63 75 72 72 65 |return t|he curre|
|00001870| 6e 74 20 77 6f 72 6b 69 | 6e 67 20 64 69 72 65 63 |nt worki|ng direc|
|00001880| 74 6f 72 79 2e 0d 0d 67 | 65 74 5f 64 69 72 65 63 |tory...g|et_direc|
|00001890| 74 6f 72 79 0d 20 20 54 | 68 69 73 20 63 6f 6d 6d |tory.  T|his comm|
|000018a0| 61 6e 64 20 77 69 6c 6c | 20 64 69 73 70 6c 61 79 |and will| display|
|000018b0| 20 61 20 73 74 61 6e 64 | 61 72 64 20 4d 61 63 69 | a stand|ard Maci|
|000018c0| 6e 74 6f 73 68 20 66 69 | 6c 65 20 64 69 61 6c 6f |ntosh fi|le dialo|
|000018d0| 67 20 61 6e 64 20 72 65 | 71 75 65 73 74 20 74 68 |g and re|quest th|
|000018e0| 65 20 75 73 65 72 20 0d | 20 20 73 65 6c 65 63 74 |e user .|  select|
|000018f0| 20 61 20 66 6f 6c 64 65 | 72 2e 20 54 68 65 20 63 | a folde|r. The c|
|00001900| 6f 6d 6d 61 6e 64 20 77 | 69 6c 6c 20 72 65 74 75 |ommand w|ill retu|
|00001910| 72 6e 20 74 68 65 20 73 | 65 6c 65 63 74 65 64 20 |rn the s|elected |
|00001920| 66 6f 6c 64 65 72 27 73 | 20 66 75 6c 6c 20 70 61 |folder's| full pa|
|00001930| 74 68 20 6e 61 6d 65 2c | 20 6f 72 20 61 6e 20 0d |th name,| or an .|
|00001940| 20 20 65 6d 70 74 79 20 | 73 74 72 69 6e 67 20 69 |  empty |string i|
|00001950| 66 20 74 68 65 20 43 61 | 6e 63 65 6c 20 62 75 74 |f the Ca|ncel but|
|00001960| 74 6f 6e 20 77 61 73 20 | 73 65 6c 65 63 74 65 64 |ton was |selected|
|00001970| 2e 0d 0d 67 65 74 65 6e | 76 20 76 61 72 6e 61 6d |...geten|v varnam|
|00001980| 65 0d 20 20 54 68 69 73 | 20 63 6f 6d 6d 61 6e 64 |e.  This| command|
|00001990| 20 77 69 6c 6c 20 72 65 | 74 75 72 6e 20 74 68 65 | will re|turn the|
|000019a0| 20 76 61 6c 75 65 20 6f | 66 20 74 68 65 20 65 6e | value o|f the en|
|000019b0| 76 69 72 6f 6e 6d 65 6e | 74 20 76 61 72 69 61 62 |vironmen|t variab|
|000019c0| 6c 65 20 76 61 72 6e 61 | 6d 65 2e 20 0d 20 20 45 |le varna|me. .  E|
|000019d0| 6e 76 69 72 6f 6e 6d 65 | 6e 74 20 76 61 72 69 61 |nvironme|nt varia|
|000019e0| 62 6c 65 73 20 61 72 65 | 20 69 6e 69 74 69 61 6c |bles are| initial|
|000019f0| 69 7a 65 64 20 62 79 20 | 72 65 61 64 69 6e 67 20 |ized by |reading |
|00001a00| 74 68 65 20 66 69 6c 65 | 20 a5 74 63 6c 65 6e 76 |the file| .tclenv|
|00001a10| 2e 20 54 68 65 20 65 6e | 76 69 72 6f 6e 6d 65 6e |. The en|vironmen|
|00001a20| 74 20 0d 20 20 66 69 6c | 65 20 68 61 73 20 74 68 |t .  fil|e has th|
|00001a30| 65 20 66 6f 72 6d 61 74 | 20 76 61 72 6e 61 6d 65 |e format| varname|
|00001a40| 3d 76 61 6c 75 65 20 61 | 73 20 69 6e 20 74 68 65 |=value a|s in the|
|00001a50| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 65 78 61 6d 70 | followi|ng examp|
|00001a60| 6c 65 3a 0d 0d 09 54 45 | 52 4d 3d 76 74 31 30 30 |le:...TE|RM=vt100|
|00001a70| 0d 09 54 43 4c 49 4e 49 | 54 3d 3a 3a 74 63 6c 3a |..TCLINI|T=::tcl:|
|00001a80| 54 63 6c 49 6e 69 74 2e | 74 63 6c 0d 09 54 43 4c |TclInit.|tcl..TCL|
|00001a90| 44 45 46 41 55 4c 54 3d | 0d 09 54 45 53 54 3d 54 |DEFAULT=|..TEST=T|
|00001aa0| 45 53 54 0d 09 54 43 4c | 50 41 54 48 3d 3a 3a 74 |EST..TCL|PATH=::t|
|00001ab0| 63 6c 3a 74 63 6c 73 68 | 3a 74 63 6c 73 72 63 0d |cl:tclsh|:tclsrc.|
|00001ac0| 0d 70 75 74 65 6e 76 20 | 76 61 72 6e 61 6d 65 20 |.putenv |varname |
|00001ad0| 76 61 6c 75 65 0d 20 20 | 54 68 69 73 20 63 6f 6d |value.  |This com|
|00001ae0| 6d 61 6e 64 20 77 69 6c | 6c 20 73 65 74 20 74 68 |mand wil|l set th|
|00001af0| 65 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 20 76 61 |e enviro|nment va|
|00001b00| 72 69 61 62 6c 65 20 76 | 61 72 6e 61 6d 65 20 74 |riable v|arname t|
|00001b10| 6f 20 76 61 6c 75 65 2e | 0d 0d 63 70 20 66 72 6f |o value.|..cp fro|
|00001b20| 6d 4e 61 6d 65 20 74 6f | 4e 61 6d 65 20 5b 66 6f |mName to|Name [fo|
|00001b30| 72 63 65 5d 0d 20 20 54 | 68 69 73 20 63 6f 6d 6d |rce].  T|his comm|
|00001b40| 61 6e 64 20 77 69 6c 6c | 20 63 6f 70 79 20 74 68 |and will| copy th|
|00001b50| 65 20 66 69 6c 65 20 66 | 72 6f 6d 4e 61 6d 65 20 |e file f|romName |
|00001b60| 61 6e 64 20 6e 61 6d 65 | 20 74 68 65 20 6e 65 77 |and name| the new|
|00001b70| 20 66 69 6c 65 20 74 6f | 4e 61 6d 65 2e 20 49 66 | file to|Name. If|
|00001b80| 20 0d 20 20 74 6f 4e 61 | 6d 65 20 69 6e 63 6c 75 | .  toNa|me inclu|
|00001b90| 64 65 73 20 61 20 70 61 | 74 68 20 6e 61 6d 65 20 |des a pa|th name |
|00001ba0| 74 68 61 74 20 69 73 20 | 64 69 66 66 65 72 65 6e |that is |differen|
|00001bb0| 74 20 66 72 6f 6d 20 74 | 68 65 20 70 61 74 68 20 |t from t|he path |
|00001bc0| 69 6e 20 66 72 6f 6d 4e | 61 6d 65 2c 20 74 68 65 |in fromN|ame, the|
|00001bd0| 20 63 6f 70 79 20 0d 20 | 20 77 69 6c 6c 20 62 65 | copy . | will be|
|00001be0| 20 6d 61 64 65 20 69 6e | 20 61 20 6e 65 77 20 64 | made in| a new d|
|00001bf0| 69 72 65 63 74 6f 72 79 | 20 28 73 70 65 63 69 66 |irectory| (specif|
|00001c00| 69 65 64 20 62 79 20 74 | 6f 4e 61 6d 65 29 2e 20 |ied by t|oName). |
|00001c10| 54 68 65 20 63 6f 70 79 | 20 63 61 6e 20 62 65 20 |The copy| can be |
|00001c20| 6d 61 64 65 20 0d 20 20 | 61 63 72 6f 73 73 20 76 |made .  |across v|
|00001c30| 6f 6c 75 6d 65 20 28 64 | 69 73 6b 20 64 72 69 76 |olume (d|isk driv|
|00001c40| 65 73 29 2e 20 54 68 65 | 20 66 6f 72 63 65 20 6f |es). The| force o|
|00001c50| 70 74 69 6f 6e 20 69 6e | 64 69 63 61 74 65 73 20 |ption in|dicates |
|00001c60| 74 68 61 74 20 74 68 65 | 20 63 6f 70 79 20 73 68 |that the| copy sh|
|00001c70| 6f 75 6c 64 20 0d 20 20 | 6f 76 65 72 77 72 69 74 |ould .  |overwrit|
|00001c80| 65 20 61 6e 79 20 65 78 | 69 73 74 69 6e 67 20 66 |e any ex|isting f|
|00001c90| 69 6c 65 20 77 69 74 68 | 20 74 68 65 20 73 61 6d |ile with| the sam|
|00001ca0| 65 20 6e 61 6d 65 20 61 | 73 20 74 6f 4e 61 6d 65 |e name a|s toName|
|00001cb0| 2e 20 54 68 69 73 20 63 | 6f 6d 6d 61 6e 64 20 63 |. This c|ommand c|
|00001cc0| 6f 70 69 65 73 20 0d 20 | 20 62 6f 74 68 20 64 61 |opies . | both da|
|00001cd0| 74 61 20 66 6f 72 6b 73 | 2c 20 61 6e 64 20 74 68 |ta forks|, and th|
|00001ce0| 65 20 46 69 6e 64 65 72 | 20 69 6e 66 6f 72 6d 61 |e Finder| informa|
|00001cf0| 74 69 6f 6e 2e 0d 0d 6d | 76 20 66 72 6f 6d 4e 61 |tion...m|v fromNa|
|00001d00| 6d 65 20 74 6f 4e 61 6d | 65 20 5b 66 6f 72 63 65 |me toNam|e [force|
|00001d10| 5d 0d 20 20 54 68 69 73 | 20 63 6f 6d 6d 61 6e 64 |].  This| command|
|00001d20| 20 77 69 6c 6c 20 6d 6f | 76 65 20 74 68 65 20 66 | will mo|ve the f|
|00001d30| 69 6c 65 20 66 72 6f 6d | 4e 61 6d 65 20 74 6f 20 |ile from|Name to |
|00001d40| 74 6f 4e 61 6d 65 2e 20 | 49 66 20 74 6f 4e 61 6d |toName. |If toNam|
|00001d50| 65 20 69 6e 63 6c 75 64 | 65 73 20 61 20 70 61 74 |e includ|es a pat|
|00001d60| 68 20 0d 20 20 6e 61 6d | 65 20 74 68 61 74 20 69 |h .  nam|e that i|
|00001d70| 73 20 64 69 66 66 65 72 | 65 6e 74 20 66 72 6f 6d |s differ|ent from|
|00001d80| 20 74 68 65 20 70 61 74 | 68 20 69 6e 20 66 72 6f | the pat|h in fro|
|00001d90| 6d 4e 61 6d 65 2c 20 74 | 68 65 20 66 69 6c 65 20 |mName, t|he file |
|00001da0| 77 69 6c 6c 20 62 65 20 | 6d 6f 76 65 64 20 69 6e |will be |moved in|
|00001db0| 74 6f 20 61 20 6e 65 77 | 20 0d 20 20 64 69 72 65 |to a new| .  dire|
|00001dc0| 63 74 6f 72 79 20 28 73 | 70 65 63 69 66 69 65 64 |ctory (s|pecified|
|00001dd0| 20 62 79 20 74 6f 4e 61 | 6d 65 29 2e 20 54 68 65 | by toNa|me). The|
|00001de0| 20 6d 6f 76 65 20 63 61 | 6e 20 6e 6f 74 20 62 65 | move ca|n not be|
|00001df0| 20 6d 61 64 65 20 61 63 | 72 6f 73 73 20 76 6f 6c | made ac|ross vol|
|00001e00| 75 6d 65 20 28 64 69 73 | 6b 20 0d 20 20 64 72 69 |ume (dis|k .  dri|
|00001e10| 76 65 73 29 2e 20 54 68 | 65 20 66 6f 72 63 65 20 |ves). Th|e force |
|00001e20| 6f 70 74 69 6f 6e 20 69 | 6e 64 69 63 61 74 65 73 |option i|ndicates|
|00001e30| 20 74 68 61 74 20 74 68 | 65 20 6d 6f 76 65 20 73 | that th|e move s|
|00001e40| 68 6f 75 6c 64 20 6f 76 | 65 72 77 72 69 74 65 20 |hould ov|erwrite |
|00001e50| 61 6e 79 20 65 78 69 73 | 74 69 6e 67 20 66 69 6c |any exis|ting fil|
|00001e60| 65 20 0d 20 20 77 69 74 | 68 20 74 68 65 20 73 61 |e .  wit|h the sa|
|00001e70| 6d 65 20 6e 61 6d 65 20 | 61 73 20 74 6f 4e 61 6d |me name |as toNam|
|00001e80| 65 2e 0d 0d 72 6d 20 66 | 69 6c 65 4e 61 6d 65 0d |e...rm f|ileName.|
|00001e90| 20 20 54 68 69 73 20 63 | 6f 6d 6d 61 6e 64 20 77 |  This c|ommand w|
|00001ea0| 69 6c 6c 20 64 65 6c 65 | 74 65 20 74 68 65 20 66 |ill dele|te the f|
|00001eb0| 69 6c 65 20 66 69 6c 65 | 4e 61 6d 65 2e 0d 0d 78 |ile file|Name...x|
|00001ec0| 74 63 6c 63 6d 64 20 5b | 2d 66 20 66 69 6c 65 6e |tclcmd [|-f filen|
|00001ed0| 61 6d 65 5d 20 63 6d 64 | 6e 61 6d 65 20 61 72 67 |ame] cmd|name arg|
|00001ee0| 75 6d 65 6e 74 5f 6c 69 | 73 74 2e 2e 2e 0d 20 20 |ument_li|st....  |
|00001ef0| 54 68 69 73 20 63 6f 6d | 6d 61 6e 64 20 77 69 6c |This com|mand wil|
|00001f00| 6c 20 6c 6f 61 64 20 74 | 68 65 20 65 78 74 65 72 |l load t|he exter|
|00001f10| 6e 61 6c 20 63 6f 6d 6d | 61 6e 64 20 63 6d 64 6e |nal comm|and cmdn|
|00001f20| 61 6d 65 20 61 6e 64 20 | 70 61 73 73 20 69 74 20 |ame and |pass it |
|00001f30| 74 68 65 20 61 72 67 75 | 6d 65 6e 74 20 0d 20 20 |the argu|ment .  |
|00001f40| 6c 69 73 74 20 5b 20 63 | 6d 64 6e 61 6d 65 20 61 |list [ c|mdname a|
|00001f50| 72 67 75 6d 65 6e 74 5f | 6c 69 73 74 2e 2e 2e 20 |rgument_|list... |
|00001f60| 5d 2e 20 45 78 74 65 72 | 6e 61 6c 20 63 6f 6d 6d |]. Exter|nal comm|
|00001f70| 61 6e 64 20 61 72 65 20 | 63 6f 64 65 20 72 65 73 |and are |code res|
|00001f80| 6f 75 72 63 65 73 20 6f | 66 20 74 79 70 65 20 0d |ources o|f type .|
|00001f90| 20 20 58 54 43 4c 2e 20 | 54 68 65 79 20 6d 61 79 |  XTCL. |They may|
|00001fa0| 20 62 65 20 6c 6f 63 61 | 74 65 64 20 69 6e 20 74 | be loca|ted in t|
|00001fb0| 68 65 20 72 65 73 6f 75 | 72 63 65 20 66 6f 72 6b |he resou|rce fork|
|00001fc0| 20 6f 66 20 74 68 65 20 | 74 69 63 6b 6c 65 20 61 | of the |tickle a|
|00001fd0| 70 70 6c 69 63 61 74 69 | 6f 6e 2c 20 6f 72 20 74 |pplicati|on, or t|
|00001fe0| 68 65 79 20 0d 20 20 6d | 61 79 20 62 65 20 6c 6f |hey .  m|ay be lo|
|00001ff0| 63 61 74 65 64 20 69 6e | 20 61 20 66 69 6c 65 20 |cated in| a file |
|00002000| 6e 61 6d 65 64 20 58 54 | 43 4c 20 46 69 6c 65 20 |named XT|CL File |
|00002010| 69 6e 20 74 68 65 20 73 | 61 6d 65 20 64 69 72 65 |in the s|ame dire|
|00002020| 63 74 6f 72 79 20 61 73 | 20 74 68 65 20 74 69 63 |ctory as| the tic|
|00002030| 6b 6c 65 20 0d 20 20 61 | 70 70 6c 69 63 61 74 69 |kle .  a|pplicati|
|00002040| 6f 6e 2e 20 49 66 20 74 | 68 65 20 6f 70 74 69 6f |on. If t|he optio|
|00002050| 6e 61 6c 20 2d 66 20 66 | 69 6c 65 6e 61 6d 65 20 |nal -f f|ilename |
|00002060| 69 73 20 69 6e 63 6c 75 | 64 65 64 2c 20 74 68 65 |is inclu|ded, the|
|00002070| 20 65 78 74 65 72 6e 61 | 6c 20 63 6f 6d 6d 61 6e | externa|l comman|
|00002080| 64 20 77 69 6c 6c 20 66 | 69 72 73 74 20 0d 20 20 |d will f|irst .  |
|00002090| 62 65 20 6c 6f 61 64 65 | 64 20 66 72 6f 6d 20 66 |be loade|d from f|
|000020a0| 69 6c 65 6e 61 6d 65 20 | 62 65 66 6f 72 65 20 74 |ilename |before t|
|000020b0| 68 65 20 6f 74 68 65 72 | 20 74 77 6f 20 66 69 6c |he other| two fil|
|000020c0| 65 73 2e 0d 20 20 53 65 | 65 20 74 68 65 20 61 70 |es..  Se|e the ap|
|000020d0| 70 65 6e 64 69 78 20 66 | 6f 72 20 61 20 64 65 74 |pendix f|or a det|
|000020e0| 61 69 6c 65 64 20 64 65 | 73 63 72 69 70 74 69 6f |ailed de|scriptio|
|000020f0| 6e 20 6f 66 20 74 68 65 | 20 65 78 74 65 72 6e 61 |n of the| externa|
|00002100| 6c 20 74 63 6c 20 63 6f | 6d 6d 61 6e 64 20 69 6e |l tcl co|mmand in|
|00002110| 74 65 72 66 61 63 65 2e | 20 0d 20 20 53 65 65 20 |terface.| .  See |
|00002120| 74 68 65 20 61 63 63 6f | 6d 70 61 6e 79 69 6e 67 |the acco|mpanying|
|00002130| 20 73 6f 75 72 63 65 73 | 20 66 6f 72 20 61 6e 20 | sources| for an |
|00002140| 65 78 61 6d 70 6c 65 20 | 6f 66 20 77 72 69 74 69 |example |of writi|
|00002150| 6e 67 20 61 6e 20 58 54 | 43 4c 2e 0d 0d 61 73 6b |ng an XT|CL...ask|
|00002160| 79 65 73 6e 6f 20 70 72 | 6f 6d 70 74 0d 20 20 54 |yesno pr|ompt.  T|
|00002170| 68 69 73 20 63 6f 6d 6d | 61 6e 64 20 77 69 6c 6c |his comm|and will|
|00002180| 20 64 69 73 70 6c 61 79 | 20 61 20 4d 61 63 69 6e | display| a Macin|
|00002190| 74 6f 73 68 20 61 6c 65 | 72 74 20 62 6f 78 20 77 |tosh ale|rt box w|
|000021a0| 69 74 68 20 70 72 6f 6d | 70 74 64 69 73 70 6c 61 |ith prom|ptdispla|
|000021b0| 79 65 64 20 77 69 74 68 | 20 74 68 65 20 0d 20 20 |yed with| the .  |
|000021c0| 70 75 73 68 20 62 75 74 | 74 6f 6e 73 20 59 65 73 |push but|tons Yes|
|000021d0| 2c 20 4e 6f 2c 20 43 61 | 6e 63 65 6c 2e 2e 20 54 |, No, Ca|ncel.. T|
|000021e0| 68 65 20 63 6f 6d 6d 61 | 6e 64 20 77 69 6c 6c 20 |he comma|nd will |
|000021f0| 72 65 74 75 72 6e 20 74 | 68 65 20 74 69 74 6c 65 |return t|he title|
|00002200| 20 6f 66 20 74 68 65 20 | 62 75 74 74 6f 6e 20 0d | of the |button .|
|00002210| 20 20 73 65 6c 65 63 74 | 65 64 20 62 79 20 74 68 |  select|ed by th|
|00002220| 65 20 75 73 65 72 2e 0d | 0d 67 65 74 6c 69 6e 65 |e user..|.getline|
|00002230| 20 70 72 6f 6d 70 74 20 | 64 65 66 61 75 6c 74 0d | prompt |default.|
|00002240| 20 20 54 68 69 73 20 63 | 6f 6d 6d 61 6e 64 20 77 |  This c|ommand w|
|00002250| 69 6c 6c 20 64 69 73 70 | 6c 61 79 20 61 20 4d 61 |ill disp|lay a Ma|
|00002260| 63 69 6e 74 6f 73 68 20 | 61 6c 65 72 74 20 62 6f |cintosh |alert bo|
|00002270| 78 20 77 69 74 68 20 70 | 72 6f 6d 70 74 64 69 73 |x with p|romptdis|
|00002280| 70 6c 61 79 65 64 2c 20 | 61 20 74 65 78 74 20 65 |played, |a text e|
|00002290| 64 69 74 20 0d 20 20 66 | 69 65 6c 64 20 77 69 74 |dit .  f|ield wit|
|000022a0| 68 20 64 65 66 61 75 6c | 74 20 69 6e 69 74 69 61 |h defaul|t initia|
|000022b0| 6c 6c 79 20 69 6e 20 74 | 68 65 20 66 69 65 6c 64 |lly in t|he field|
|000022c0| 2c 20 61 6e 64 20 77 69 | 74 68 20 74 68 65 20 70 |, and wi|th the p|
|000022d0| 75 73 68 20 62 75 74 74 | 6f 6e 73 20 4f 4b 2c 20 |ush butt|ons OK, |
|000022e0| 43 61 6e 63 65 6c 2e 2e | 20 54 68 65 20 0d 20 20 |Cancel..| The .  |
|000022f0| 63 6f 6d 6d 61 6e 64 20 | 77 69 6c 6c 20 72 65 74 |command |will ret|
|00002300| 75 72 6e 20 74 68 65 20 | 74 65 78 74 20 65 6e 74 |urn the |text ent|
|00002310| 65 72 65 64 20 69 6e 74 | 6f 20 74 68 65 20 74 65 |ered int|o the te|
|00002320| 78 74 20 65 64 69 74 20 | 66 69 65 6c 64 20 62 79 |xt edit |field by|
|00002330| 20 74 68 65 20 75 73 65 | 72 2c 20 6f 72 20 61 6e | the use|r, or an|
|00002340| 20 65 6d 70 74 79 20 0d | 20 20 73 74 72 69 6e 67 | empty .|  string|
|00002350| 20 69 66 20 74 68 65 20 | 75 73 65 72 20 73 65 6c | if the |user sel|
|00002360| 65 63 74 65 64 20 74 68 | 65 20 43 61 6e 63 65 6c |ected th|e Cancel|
|00002370| 20 62 75 74 74 6f 6e 2e | 0d 0d 67 65 74 66 69 6c | button.|..getfil|
|00002380| 65 20 70 72 6f 6d 70 74 | 0d 20 20 54 68 69 73 20 |e prompt|.  This |
|00002390| 63 6f 6d 6d 61 6e 64 20 | 77 69 6c 6c 20 64 69 73 |command |will dis|
|000023a0| 70 6c 61 79 20 61 6e 20 | 53 46 47 65 74 46 69 6c |play an |SFGetFil|
|000023b0| 65 28 29 20 61 6e 64 20 | 72 65 74 75 72 6e 20 74 |e() and |return t|
|000023c0| 68 65 20 66 75 6c 6c 20 | 70 61 74 68 20 6e 61 6d |he full |path nam|
|000023d0| 65 20 6f 66 20 74 68 65 | 20 0d 20 20 73 65 6c 65 |e of the| .  sele|
|000023e0| 63 74 65 64 20 66 69 6c | 65 2c 20 6f 72 20 61 6e |cted fil|e, or an|
|000023f0| 20 65 6d 70 74 79 20 73 | 74 72 69 6e 67 20 69 66 | empty s|tring if|
|00002400| 20 43 41 4e 43 45 4c 20 | 62 75 74 74 6f 6e 20 77 | CANCEL |button w|
|00002410| 61 73 20 73 65 6c 65 63 | 74 65 64 2e 0d 0d 70 75 |as selec|ted...pu|
|00002420| 74 66 69 6c 65 20 70 72 | 6f 6d 70 74 20 6f 72 69 |tfile pr|ompt ori|
|00002430| 67 69 6e 61 6c 0d 20 20 | 54 68 69 73 20 63 6f 6d |ginal.  |This com|
|00002440| 6d 61 6e 64 20 77 69 6c | 6c 20 64 69 73 70 6c 61 |mand wil|l displa|
|00002450| 79 20 61 6e 20 53 46 50 | 75 74 46 69 6c 65 28 29 |y an SFP|utFile()|
|00002460| 20 61 6e 64 20 72 65 74 | 75 72 6e 20 74 68 65 20 | and ret|urn the |
|00002470| 66 75 6c 6c 20 70 61 74 | 68 20 6e 61 6d 65 20 6f |full pat|h name o|
|00002480| 66 20 74 68 65 20 0d 20 | 20 73 65 6c 65 63 74 65 |f the . | selecte|
|00002490| 64 20 66 69 6c 65 2c 20 | 6f 72 20 61 6e 20 65 6d |d file, |or an em|
|000024a0| 70 74 79 20 73 74 72 69 | 6e 67 20 69 66 20 43 41 |pty stri|ng if CA|
|000024b0| 4e 43 45 4c 20 62 75 74 | 74 6f 6e 20 77 61 73 20 |NCEL but|ton was |
|000024c0| 73 65 6c 65 63 74 65 64 | 2e 20 4f 72 69 67 69 6e |selected|. Origin|
|000024d0| 61 6c 20 69 73 20 74 68 | 65 20 0d 20 20 64 65 66 |al is th|e .  def|
|000024e0| 61 75 6c 74 20 6e 61 6d | 65 20 64 69 73 70 6c 61 |ault nam|e displa|
|000024f0| 79 65 64 20 66 6f 72 20 | 74 68 65 20 75 73 65 72 |yed for |the user|
|00002500| 2e 0d 0d 67 65 74 66 69 | 6e 66 6f 20 66 69 6c 65 |...getfi|nfo file|
|00002510| 4e 61 6d 65 0d 20 20 54 | 68 69 73 20 63 6f 6d 6d |Name.  T|his comm|
|00002520| 61 6e 64 20 77 69 6c 6c | 20 64 69 73 70 6c 61 79 |and will| display|
|00002530| 20 74 68 65 20 73 74 61 | 6e 64 61 72 64 20 4d 61 | the sta|ndard Ma|
|00002540| 63 69 6e 74 6f 73 68 20 | 66 69 6c 65 20 69 6e 66 |cintosh |file inf|
|00002550| 6f 72 6d 61 74 69 6f 6e | 20 69 6e 20 74 68 65 20 |ormation| in the |
|00002560| 66 6f 72 6d 3a 0d 20 20 | 22 27 61 65 51 4c 27 20 |form:.  |"'aeQL' |
|00002570| 27 51 55 49 4c 27 20 6c | 76 62 73 49 64 6d 20 30 |'QUIL' l|vbsIdm 0|
|00002580| 32 2f 31 37 2f 39 32 20 | 32 33 3a 35 37 3a 31 32 |2/17/92 |23:57:12|
|00002590| 20 30 32 2f 31 39 2f 39 | 32 20 32 32 3a 34 33 3a | 02/19/9|2 22:43:|
|000025a0| 33 36 20 30 2c 31 35 36 | 20 32 31 39 20 30 22 2e |36 0,156| 219 0".|
|000025b0| 0d 20 20 54 68 65 20 66 | 69 65 6c 64 73 20 61 72 |.  The f|ields ar|
|000025c0| 65 20 74 68 65 20 66 64 | 43 72 65 61 74 6f 72 2c |e the fd|Creator,|
|000025d0| 20 66 64 54 79 70 65 2c | 20 66 64 46 6c 61 67 73 | fdType,| fdFlags|
|000025e0| 2c 20 66 6c 43 72 65 61 | 74 69 6f 6e 44 61 74 65 |, flCrea|tionDate|
|000025f0| 2c 20 66 6c 43 72 65 61 | 74 69 6f 6e 74 69 6d 65 |, flCrea|tiontime|
|00002600| 2c 20 0d 20 20 66 6c 4d | 6f 64 44 61 74 65 2c 20 |, .  flM|odDate, |
|00002610| 66 6c 4d 6f 64 54 69 6d | 65 2c 20 66 64 4c 6f 63 |flModTim|e, fdLoc|
|00002620| 61 74 69 6f 6e 2e 48 2c | 56 2c 20 64 61 74 61 46 |ation.H,|V, dataF|
|00002630| 6f 72 6c 4c 65 6e 67 74 | 68 2c 20 72 73 72 63 46 |orlLengt|h, rsrcF|
|00002640| 6f 72 6b 4c 65 6e 67 74 | 68 2c 20 0d 20 20 72 65 |orkLengt|h, .  re|
|00002650| 73 70 65 63 74 69 76 65 | 6c 79 2e 20 54 68 65 20 |spective|ly. The |
|00002660| 66 64 46 6c 61 67 73 20 | 66 69 65 6c 64 20 75 73 |fdFlags |field us|
|00002670| 65 73 20 63 68 61 72 61 | 63 74 65 72 73 20 74 6f |es chara|cters to|
|00002680| 20 72 65 70 72 65 73 65 | 6e 74 20 62 69 74 73 3a | represe|nt bits:|
|00002690| 0d 09 6c 2f 4c 09 6e 6f | 74 20 6c 6f 63 61 6b 65 |..l/L.no|t locake|
|000026a0| 64 2f 4c 6f 63 6b 65 64 | 0d 09 76 2f 56 09 76 69 |d/Locked|..v/V.vi|
|000026b0| 73 69 62 6c 65 2f 6e 6f | 74 56 69 73 69 62 6c 65 |sible/no|tVisible|
|000026c0| 0d 09 62 2f 42 09 6e 6f | 74 20 62 75 6e 64 6c 65 |..b/B.no|t bundle|
|000026d0| 64 2f 42 75 6e 64 6c 65 | 64 0d 09 73 2f 53 09 6e |d/Bundle|d..s/S.n|
|000026e0| 6f 74 20 73 79 73 74 65 | 6d 2f 53 79 73 74 65 6d |ot syste|m/System|
|000026f0| 0d 09 69 2f 49 09 6e 6f | 74 20 69 6e 69 74 69 61 |..i/I.no|t initia|
|00002700| 6c 69 7a 65 64 2f 49 6e | 69 74 69 61 6c 69 7a 65 |lized/In|itialize|
|00002710| 64 0d 09 64 2f 44 09 6e | 6f 74 20 64 65 73 6b 74 |d..d/D.n|ot deskt|
|00002720| 6f 70 2f 44 65 73 6b 74 | 6f 70 0d 09 6d 2f 4d 09 |op/Deskt|op..m/M.|
|00002730| 6e 6f 74 20 73 68 61 72 | 61 62 6c 65 2f 73 68 61 |not shar|able/sha|
|00002740| 72 61 62 6c 65 0d 0d 73 | 65 74 66 69 6e 66 6f 20 |rable..s|etfinfo |
|00002750| 66 69 6c 65 4e 61 6d 65 | 20 5b 2d 61 20 66 6c 61 |fileName| [-a fla|
|00002760| 67 73 5d 0d 09 09 09 5b | 2d 63 20 66 64 43 72 65 |gs]....[|-c fdCre|
|00002770| 61 74 6f 72 5d 20 5b 2d | 74 20 66 64 54 79 70 65 |ator] [-|t fdType|
|00002780| 73 5d 0d 20 20 54 68 69 | 73 20 63 6f 6d 6d 61 6e |s].  Thi|s comman|
|00002790| 64 20 77 69 6c 6c 20 73 | 65 74 20 74 68 65 20 73 |d will s|et the s|
|000027a0| 74 61 6e 64 61 72 64 20 | 4d 61 63 69 6e 74 6f 73 |tandard |Macintos|
|000027b0| 68 20 66 69 6c 65 20 69 | 6e 66 6f 72 6d 61 74 69 |h file i|nformati|
|000027c0| 6f 6e 2e 20 54 68 65 20 | 66 6c 61 67 73 20 73 65 |on. The |flags se|
|000027d0| 74 74 69 6e 67 20 0d 20 | 20 6d 75 73 74 20 62 65 |tting . | must be|
|000027e0| 20 6f 66 20 74 68 65 20 | 73 61 6d 65 20 66 6f 72 | of the |same for|
|000027f0| 6d 61 74 20 61 73 20 64 | 69 73 70 6c 61 79 65 64 |mat as d|isplayed|
|00002800| 20 62 79 20 74 68 65 20 | 67 65 74 66 69 6e 66 6f | by the |getfinfo|
|00002810| 20 66 6c 61 67 2e 0d 0d | 66 65 65 64 62 61 63 6b | flag...|feedback|
|00002820| 20 73 74 72 69 6e 67 0d | 20 20 54 68 69 73 20 63 | string.|  This c|
|00002830| 6f 6d 6d 61 6e 64 20 77 | 69 6c 6c 20 64 69 73 70 |ommand w|ill disp|
|00002840| 6c 61 79 20 74 68 65 20 | 73 74 72 69 6e 67 20 69 |lay the |string i|
|00002850| 6e 20 74 68 65 20 66 65 | 65 64 62 61 63 6b 20 77 |n the fe|edback w|
|00002860| 69 6e 64 6f 77 2c 20 61 | 73 20 77 65 6c 6c 20 61 |indow, a|s well a|
|00002870| 73 20 6c 6f 67 20 74 68 | 65 20 0d 20 20 73 74 72 |s log th|e .  str|
|00002880| 69 6e 67 20 69 66 20 6c | 6f 67 67 69 6e 67 20 69 |ing if l|ogging i|
|00002890| 73 20 74 75 72 6e 65 64 | 20 6f 6e 2e 0d 0d 63 74 |s turned| on...ct|
|000028a0| 69 6d 65 20 74 69 6d 65 | 0d 20 20 54 68 69 73 20 |ime time|.  This |
|000028b0| 63 6f 6d 6d 61 6e 64 20 | 77 69 6c 6c 20 72 65 74 |command |will ret|
|000028c0| 75 72 6e 20 61 20 55 4e | 49 58 20 74 69 6d 65 20 |urn a UN|IX time |
|000028d0| 73 74 72 69 6e 67 20 6f | 66 20 74 68 65 20 66 6f |string o|f the fo|
|000028e0| 72 6d 61 74 20 22 57 65 | 64 20 46 65 62 20 31 39 |rmat "We|d Feb 19|
|000028f0| 20 0d 20 20 32 32 3a 34 | 33 3a 33 36 20 31 39 39 | .  22:4|3:36 199|
|00002900| 32 22 2e 20 54 68 65 20 | 70 61 72 61 6d 65 74 65 |2". The |paramete|
|00002910| 72 20 74 69 6d 65 20 69 | 73 20 69 6e 20 4d 61 63 |r time i|s in Mac|
|00002920| 69 6e 74 6f 73 68 20 73 | 65 63 6f 6e 64 73 2c 20 |intosh s|econds, |
|00002930| 61 6e 64 20 77 6f 75 6c | 64 20 62 65 20 74 68 65 |and woul|d be the|
|00002940| 20 0d 20 20 72 65 73 75 | 6c 74 20 6f 66 20 61 20 | .  resu|lt of a |
|00002950| 6e 6f 77 20 6f 72 20 66 | 69 6c 65 20 6d 74 69 6d |now or f|ile mtim|
|00002960| 65 20 63 6f 6d 6d 61 6e | 64 20 6f 72 20 74 68 65 |e comman|d or the|
|00002970| 20 6c 69 6b 65 2e 0d 0d | 6e 6f 77 0d 20 20 52 65 | like...|now.  Re|
|00002980| 74 75 72 6e 73 20 74 68 | 65 20 63 75 72 72 65 6e |turns th|e curren|
|00002990| 74 20 74 69 6d 65 20 61 | 73 20 4d 61 63 69 6e 74 |t time a|s Macint|
|000029a0| 6f 73 68 20 73 65 63 6f | 6e 64 73 2e 20 54 68 69 |osh seco|nds. Thi|
|000029b0| 73 20 69 73 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |s is the| number |
|000029c0| 6f 66 20 73 65 63 6f 6e | 64 73 20 74 68 61 74 20 |of secon|ds that |
|000029d0| 0d 20 20 68 61 76 65 20 | 65 6c 61 70 73 65 64 20 |.  have |elapsed |
|000029e0| 73 69 6e 63 65 20 4d 69 | 64 6e 69 67 68 74 20 4a |since Mi|dnight J|
|000029f0| 61 6e 20 31 2c 20 31 39 | 30 34 2e 20 41 70 70 72 |an 1, 19|04. Appr|
|00002a00| 6f 70 72 69 61 74 65 20 | 66 6f 72 20 69 6e 70 75 |opriate |for inpu|
|00002a10| 74 20 74 6f 20 63 74 69 | 6d 65 2e 0d 0d 74 69 63 |t to cti|me...tic|
|00002a20| 6b 73 0d 20 20 52 65 74 | 75 72 6e 73 20 74 68 65 |ks.  Ret|urns the|
|00002a30| 20 63 75 72 72 65 6e 74 | 20 54 69 63 6b 43 6f 75 | current| TickCou|
|00002a40| 6e 74 2e 20 54 69 63 6b | 73 20 61 72 65 20 36 30 |nt. Tick|s are 60|
|00002a50| 74 68 73 20 6f 66 20 61 | 20 73 65 63 6f 6e 64 73 |ths of a| seconds|
|00002a60| 2e 20 54 69 63 6b 43 6f | 75 6e 74 20 69 73 20 74 |. TickCo|unt is t|
|00002a70| 68 65 20 0d 20 20 6e 75 | 6d 62 65 72 20 6f 66 20 |he .  nu|mber of |
|00002a80| 74 69 63 6b 73 20 73 69 | 6e 63 65 20 74 68 65 20 |ticks si|nce the |
|00002a90| 4d 61 63 69 6e 74 6f 73 | 68 20 77 61 73 20 73 74 |Macintos|h was st|
|00002aa0| 61 72 74 65 64 2e 20 54 | 68 65 20 63 6f 6d 6d 61 |arted. T|he comma|
|00002ab0| 6e 64 3a 0d 09 09 70 75 | 74 73 20 73 74 64 6f 75 |nd:...pu|ts stdou|
|00002ac0| 74 20 5b 65 78 70 72 20 | 22 5b 74 69 63 6b 73 5d |t [expr |"[ticks]|
|00002ad0| 20 2f 20 36 30 22 5d 0d | 20 20 77 69 6c 6c 20 70 | / 60"].|  will p|
|00002ae0| 72 69 6e 74 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |rint the| number |
|00002af0| 6f 66 20 73 65 63 6f 6e | 64 73 20 73 69 6e 63 65 |of secon|ds since|
|00002b00| 20 74 68 65 20 4d 61 63 | 69 6e 74 6f 73 68 20 77 | the Mac|intosh w|
|00002b10| 61 73 20 62 6f 6f 74 65 | 64 2e 0d 0d 6d 74 69 6d |as boote|d...mtim|
|00002b20| 65 20 74 69 6d 65 20 3f | 6c 6f 6e 67 2f 73 68 6f |e time ?|long/sho|
|00002b30| 72 74 2f 61 62 62 72 65 | 76 3f 0d 20 20 52 65 74 |rt/abbre|v?.  Ret|
|00002b40| 75 72 6e 73 20 61 20 64 | 61 74 65 20 61 6e 64 20 |urns a d|ate and |
|00002b50| 74 69 6d 65 20 73 74 72 | 69 6e 67 20 75 73 69 6e |time str|ing usin|
|00002b60| 67 20 74 68 65 20 4d 61 | 63 69 6e 74 6f 73 68 20 |g the Ma|cintosh |
|00002b70| 49 6e 74 65 72 6e 61 74 | 69 6f 6e 61 6c 20 55 74 |Internat|ional Ut|
|00002b80| 69 6c 69 74 69 65 73 2e | 20 54 68 65 20 0d 20 20 |ilities.| The .  |
|00002b90| 6c 6f 6e 67 2f 73 68 6f | 72 74 2f 61 62 62 72 65 |long/sho|rt/abbre|
|00002ba0| 76 20 73 70 65 63 69 66 | 69 63 61 74 69 6f 6e 20 |v specif|ication |
|00002bb0| 63 6f 72 72 65 73 70 6f | 6e 64 73 20 74 6f 20 74 |correspo|nds to t|
|00002bc0| 68 65 20 64 61 74 65 2e | 20 54 68 65 73 65 20 61 |he date.| These a|
|00002bd0| 72 65 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |re the f|ollowing|
|00002be0| 20 0d 20 20 66 6f 72 6d | 61 74 73 3a 0d 09 73 68 | .  form|ats:..sh|
|00002bf0| 6f 72 74 09 09 33 2f 31 | 36 2f 39 32 20 39 3a 32 |ort..3/1|6/92 9:2|
|00002c00| 30 3a 34 36 20 50 4d 0d | 09 61 62 62 72 65 76 09 |0:46 PM.|.abbrev.|
|00002c10| 4d 6f 6e 2c 20 4d 61 72 | 20 31 36 2c 20 31 39 39 |Mon, Mar| 16, 199|
|00002c20| 32 20 39 3a 32 30 3a 34 | 39 20 50 4d 0d 09 6c 6f |2 9:20:4|9 PM..lo|
|00002c30| 6e 67 09 09 4d 6f 6e 64 | 61 79 2c 20 4d 61 72 63 |ng..Mond|ay, Marc|
|00002c40| 68 20 31 36 2c 20 31 39 | 39 32 20 39 3a 32 30 3a |h 16, 19|92 9:20:|
|00002c50| 34 33 20 50 4d 0d 0d 6c | 69 73 74 70 69 63 6b 20 |43 PM..l|istpick |
|00002c60| 2d 70 20 70 72 6f 6d 70 | 74 20 6c 69 73 74 0d 20 |-p promp|t list. |
|00002c70| 20 54 68 69 73 20 63 6f | 6d 6d 61 6e 64 20 77 69 | This co|mmand wi|
|00002c80| 6c 6c 20 64 69 73 70 6c | 61 79 20 61 20 64 69 61 |ll displ|ay a dia|
|00002c90| 6c 6f 67 20 77 69 74 68 | 20 74 68 65 20 6c 69 73 |log with| the lis|
|00002ca0| 74 20 64 69 73 70 6c 61 | 79 65 64 20 69 6e 20 61 |t displa|yed in a|
|00002cb0| 20 4c 69 73 74 20 4d 61 | 6e 61 67 65 72 20 6c 69 | List Ma|nager li|
|00002cc0| 73 74 2e 20 49 66 20 0d | 20 20 74 68 65 20 75 73 |st. If .|  the us|
|00002cd0| 65 72 20 70 72 65 73 73 | 65 73 20 74 68 65 20 43 |er press|es the C|
|00002ce0| 61 6e 63 65 6c 20 62 75 | 74 74 6f 6e 2c 20 61 6e |ancel bu|tton, an|
|00002cf0| 20 65 6d 70 74 79 20 73 | 74 72 69 6e 67 20 69 73 | empty s|tring is|
|00002d00| 20 72 65 74 75 72 6e 65 | 64 2e 20 49 66 20 74 68 | returne|d. If th|
|00002d10| 65 20 75 73 65 72 20 73 | 65 6c 65 63 74 73 20 0d |e user s|elects .|
|00002d20| 20 20 74 68 65 20 4f 70 | 65 6e 20 62 75 74 74 6f |  the Op|en butto|
|00002d30| 6e 2c 20 6f 72 20 64 6f | 75 62 6c 65 20 63 6c 69 |n, or do|uble cli|
|00002d40| 63 6b 73 20 61 6e 20 69 | 74 65 6d 20 69 6e 20 74 |cks an i|tem in t|
|00002d50| 68 65 20 6c 69 73 74 2c | 20 74 68 61 74 20 69 74 |he list,| that it|
|00002d60| 65 6d 20 77 69 6c 6c 20 | 62 65 20 72 65 74 75 72 |em will |be retur|
|00002d70| 6e 65 64 2e 0d 0d 67 6c | 6f 62 0d 0d 54 68 65 20 |ned...gl|ob..The |
|00002d80| 6f 72 69 67 69 6e 61 6c | 20 67 6c 6f 62 20 70 72 |original| glob pr|
|00002d90| 6f 76 69 64 65 64 20 62 | 79 20 74 68 65 20 55 4e |ovided b|y the UN|
|00002da0| 49 58 20 76 65 72 73 69 | 6f 6e 20 6f 66 20 74 63 |IX versi|on of tc|
|00002db0| 6c 20 77 61 73 20 6e 6f | 74 20 71 75 69 74 65 20 |l was no|t quite |
|00002dc0| 61 64 65 71 75 61 74 65 | 20 66 6f 72 20 0d 74 68 |adequate| for .th|
|00002dd0| 65 20 6d 6f 72 65 20 63 | 6f 6d 70 6c 65 78 20 4d |e more c|omplex M|
|00002de0| 61 63 69 6e 74 6f 73 68 | 20 66 69 6c 65 20 73 79 |acintosh| file sy|
|00002df0| 73 74 65 6d 2e 20 49 73 | 73 75 65 73 20 73 75 63 |stem. Is|sues suc|
|00002e00| 68 20 61 73 20 69 6e 76 | 69 73 69 62 6c 65 20 66 |h as inv|isible f|
|00002e10| 69 6c 65 20 68 61 6e 64 | 6c 69 6e 67 2c 20 0d 46 |ile hand|ling, .F|
|00002e20| 69 6e 64 65 72 20 74 79 | 70 65 20 61 6e 64 20 63 |inder ty|pe and c|
|00002e30| 72 65 61 74 6f 72 20 66 | 69 6c 74 65 72 69 6e 67 |reator f|iltering|
|00002e40| 2c 20 61 6e 64 20 73 70 | 61 63 65 20 68 61 6e 64 |, and sp|ace hand|
|00002e50| 6c 69 6e 67 20 69 6e 20 | 66 69 6c 65 20 6e 61 6d |ling in |file nam|
|00002e60| 65 73 2e 20 52 65 6c 65 | 61 73 65 20 36 20 6f 66 |es. Rele|ase 6 of|
|00002e70| 20 74 63 6c 20 0d 68 61 | 73 20 64 65 61 6c 74 20 | tcl .ha|s dealt |
|00002e80| 77 69 74 68 20 74 68 65 | 20 6f 72 69 67 69 6e 61 |with the| origina|
|00002e90| 6c 20 70 72 6f 62 6c 65 | 6d 20 77 69 74 68 20 73 |l proble|m with s|
|00002ea0| 70 61 63 65 73 20 69 6e | 20 66 69 6c 65 6e 61 6d |paces in| filenam|
|00002eb0| 65 73 2c 20 62 75 74 20 | 74 68 65 20 66 6f 6c 6c |es, but |the foll|
|00002ec0| 6f 77 69 6e 67 20 0d 6f | 70 74 69 6f 6e 73 20 61 |owing .o|ptions a|
|00002ed0| 72 65 20 70 72 6f 76 69 | 64 65 64 20 74 6f 20 64 |re provi|ded to d|
|00002ee0| 65 61 6c 20 77 69 74 68 | 20 61 64 64 69 74 69 6f |eal with| additio|
|00002ef0| 6e 61 6c 20 4d 61 63 69 | 6e 74 6f 73 68 20 69 73 |nal Maci|ntosh is|
|00002f00| 73 75 65 73 2e 0d 0d 41 | 6e 79 68 6f 77 2c 20 74 |sues...A|nyhow, t|
|00002f10| 68 65 20 6e 65 77 20 67 | 6c 6f 62 20 6e 6f 77 20 |he new g|lob now |
|00002f20| 74 61 6b 65 73 20 73 65 | 76 65 72 61 6c 20 6f 70 |takes se|veral op|
|00002f30| 74 69 6f 6e 73 2e 20 54 | 68 65 79 20 61 72 65 3a |tions. T|hey are:|
|00002f40| 0d 09 2d 69 09 54 68 69 | 73 20 6f 70 74 69 6f 6e |..-i.Thi|s option|
|00002f50| 20 63 61 75 73 65 73 20 | 67 6c 6f 62 20 74 6f 20 | causes |glob to |
|00002f60| 6c 69 73 74 20 69 6e 76 | 69 73 69 62 6c 65 20 66 |list inv|isible f|
|00002f70| 69 6c 65 73 20 61 6c 73 | 6f 2e 0d 09 2d 74 20 54 |iles als|o...-t T|
|00002f80| 59 50 45 09 54 68 69 73 | 20 6f 70 74 69 6f 6e 20 |YPE.This| option |
|00002f90| 63 61 75 73 65 73 20 67 | 6c 6f 62 20 74 6f 20 6f |causes g|lob to o|
|00002fa0| 6e 6c 79 20 6c 69 73 74 | 20 66 69 6c 65 20 77 69 |nly list| file wi|
|00002fb0| 74 68 20 74 68 65 20 0d | 09 09 69 6e 64 69 63 61 |th the .|..indica|
|00002fc0| 74 65 64 20 46 69 6e 64 | 65 72 20 66 69 6c 65 20 |ted Find|er file |
|00002fd0| 74 79 70 65 54 59 50 45 | 2e 20 54 68 69 73 20 6f |typeTYPE|. This o|
|00002fe0| 70 74 69 6f 6e 20 6d 61 | 79 20 62 65 20 0d 09 09 |ption ma|y be ...|
|00002ff0| 75 73 65 64 20 77 69 74 | 68 20 74 68 65 20 2d 63 |used wit|h the -c|
|00003000| 20 6f 70 74 69 6f 6e 2e | 0d 09 2d 63 20 43 52 54 | option.|..-c CRT|
|00003010| 52 09 54 68 69 73 20 6f | 70 74 69 6f 6e 20 63 61 |R.This o|ption ca|
|00003020| 75 73 65 73 20 67 6c 6f | 62 20 74 6f 20 6f 6e 6c |uses glo|b to onl|
|00003030| 79 20 6c 69 73 74 20 66 | 69 6c 65 20 77 69 74 68 |y list f|ile with|
|00003040| 20 74 68 65 20 0d 09 09 | 69 6e 64 69 63 61 74 65 | the ...|indicate|
|00003050| 64 20 46 69 6e 64 65 72 | 20 66 69 6c 65 20 63 72 |d Finder| file cr|
|00003060| 65 61 74 6f 72 43 52 54 | 52 2e 20 54 68 69 73 20 |eatorCRT|R. This |
|00003070| 6f 70 74 69 6f 6e 20 6d | 61 79 20 0d 09 09 62 65 |option m|ay ...be|
|00003080| 20 75 73 65 64 20 77 69 | 74 68 20 74 68 65 20 2d | used wi|th the -|
|00003090| 74 20 6f 70 74 69 6f 6e | 2e 0d 09 09 41 6c 73 6f |t option|....Also|
|000030a0| 20 6e 6f 74 65 20 74 68 | 61 74 20 74 68 65 20 6f | note th|at the o|
|000030b0| 72 69 67 69 6e 61 6c 20 | 67 6c 6f 62 20 77 6f 75 |riginal |glob wou|
|000030c0| 6c 64 20 73 6b 69 70 20 | 64 6f 74 20 66 69 6c 65 |ld skip |dot file|
|000030d0| 73 0d 09 09 28 69 2e 65 | 2e 2c 20 66 69 6c 65 20 |s...(i.e|., file |
|000030e0| 6e 61 6d 65 73 20 74 68 | 65 20 62 65 67 69 6e 20 |names th|e begin |
|000030f0| 77 69 74 68 20 61 20 70 | 65 72 69 6f 64 29 20 0d |with a p|eriod) .|
|00003100| 09 09 69 6e 20 74 68 65 | 20 6c 69 73 74 69 6e 67 |..in the| listing|
|00003110| 2c 20 75 6e 6c 65 73 73 | 20 74 68 65 20 70 61 74 |, unless| the pat|
|00003120| 74 65 72 6e 20 62 65 67 | 61 6e 20 77 69 74 68 20 |tern beg|an with |
|00003130| 61 20 70 65 72 69 6f 64 | 2e 0d 09 09 54 69 63 6b |a period|....Tick|
|00003140| 6c 65 20 65 78 74 65 6e | 64 73 20 74 68 69 73 20 |le exten|ds this |
|00003150| 63 6f 6e 63 65 70 74 20 | 6f 6e 65 20 73 74 65 70 |concept |one step|
|00003160| 20 66 75 72 74 68 65 72 | 20 6f 6e 20 74 68 65 0d | further| on the.|
|00003170| 09 09 4d 61 63 69 6e 74 | 6f 73 68 2c 20 61 6e 64 |..Macint|osh, and|
|00003180| 20 73 6b 69 70 73 20 73 | 70 6f 74 20 66 69 6c 65 | skips s|pot file|
|00003190| 73 20 28 69 2e 65 2e 2c | 20 66 69 6c 65 20 6e 61 |s (i.e.,| file na|
|000031a0| 6d 65 73 20 74 68 61 74 | 20 0d 09 09 62 65 67 69 |mes that| ...begi|
|000031b0| 6e 20 77 69 74 68 20 27 | a5 27 29 2c 20 75 6e 6c |n with '|.'), unl|
|000031c0| 65 73 73 20 74 68 65 20 | 70 61 74 74 65 72 6e 20 |ess the |pattern |
|000031d0| 73 74 61 72 74 73 20 77 | 69 74 68 20 61 20 73 70 |starts w|ith a sp|
|000031e0| 6f 74 2e 0d 0d 79 69 65 | 6c 64 5f 6d 61 63 20 3f |ot...yie|ld_mac ?|
|000031f0| 74 69 63 6b 73 3f 20 2a | 2a 2a 20 4e 4f 54 20 59 |ticks? *|** NOT Y|
|00003200| 45 54 20 49 4e 43 4f 52 | 50 4f 52 41 54 45 44 20 |ET INCOR|PORATED |
|00003210| 49 4e 54 4f 20 41 4c 50 | 48 41 20 2a 2a 2a 0d 20 |INTO ALP|HA ***. |
|00003220| 20 54 68 69 73 20 77 69 | 6c 6c 20 63 61 75 73 65 | This wi|ll cause|
|00003230| 20 74 63 6c 20 74 6f 20 | 63 61 6c 6c 20 57 61 69 | tcl to |call Wai|
|00003240| 74 4e 65 78 74 45 76 65 | 6e 74 2c 20 61 6c 6c 6f |tNextEve|nt, allo|
|00003250| 77 69 6e 67 20 6f 74 68 | 65 72 20 70 72 6f 63 65 |wing oth|er proce|
|00003260| 73 73 65 73 20 74 6f 20 | 72 75 6e 20 64 75 72 69 |sses to |run duri|
|00003270| 6e 67 20 0d 20 20 43 50 | 55 20 69 6e 74 65 6e 73 |ng .  CP|U intens|
|00003280| 69 76 65 20 74 63 6c 20 | 73 63 72 69 70 74 73 2c |ive tcl |scripts,|
|00003290| 20 61 73 20 77 65 6c 6c | 20 61 73 20 61 6c 6c 6f | as well| as allo|
|000032a0| 77 69 6e 67 20 74 68 65 | 20 75 73 65 72 20 74 6f |wing the| user to|
|000032b0| 20 73 77 69 74 63 68 20 | 61 70 70 6c 69 63 61 74 | switch |applicat|
|000032c0| 69 6f 6e 20 77 68 69 6c | 65 20 61 20 0d 20 20 70 |ion whil|e a .  p|
|000032d0| 61 72 74 69 63 75 6c 61 | 72 6c 79 20 6c 6f 6e 67 |articula|rly long|
|000032e0| 20 73 63 72 69 70 74 20 | 69 73 20 65 78 65 63 75 | script |is execu|
|000032f0| 74 69 6e 67 2e 20 54 68 | 65 20 74 69 63 6b 73 20 |ting. Th|e ticks |
|00003300| 61 72 67 75 6d 65 6e 74 | 20 64 65 74 65 72 6d 69 |argument| determi|
|00003310| 6e 65 73 20 74 68 65 20 | 73 6c 65 65 70 5f 74 69 |nes the |sleep_ti|
|00003320| 6d 65 20 0d 20 20 74 69 | 63 6b 73 20 70 61 73 73 |me .  ti|cks pass|
|00003330| 65 64 20 74 6f 20 57 61 | 69 74 4e 65 78 74 45 76 |ed to Wa|itNextEv|
|00003340| 65 6e 74 28 29 20 61 6e | 64 20 61 73 20 73 75 63 |ent() an|d as suc|
|00003350| 68 20 64 65 74 65 72 6d | 69 6e 65 20 74 68 65 20 |h determ|ine the |
|00003360| 61 6d 6f 75 6e 74 20 6f | 66 20 73 68 61 72 69 6e |amount o|f sharin|
|00003370| 67 20 6f 66 20 74 68 65 | 20 0d 20 20 43 50 55 20 |g of the| .  CPU |
|00003380| 74 68 61 74 20 77 69 6c | 6c 20 62 65 20 61 63 63 |that wil|l be acc|
|00003390| 6f 6d 70 6c 69 73 68 65 | 64 2e 20 4c 61 72 67 65 |omplishe|d. Large|
|000033a0| 72 20 74 69 63 6b 73 20 | 76 61 6c 75 65 73 20 77 |r ticks |values w|
|000033b0| 69 6c 6c 20 73 6c 6f 77 | 20 64 6f 77 6e 20 74 68 |ill slow| down th|
|000033c0| 65 20 74 63 6c 20 73 63 | 72 69 70 74 20 0d 20 20 |e tcl sc|ript .  |
|000033d0| 61 6c 6c 6f 77 69 6e 67 | 20 6f 74 68 65 72 20 70 |allowing| other p|
|000033e0| 72 6f 67 72 61 6d 73 20 | 6d 6f 72 65 20 6f 66 20 |rograms |more of |
|000033f0| 74 68 65 20 43 50 55 2e | 20 53 6d 61 6c 6c 65 72 |the CPU.| Smaller|
|00003400| 20 74 69 63 6b 73 20 76 | 61 6c 75 65 73 20 77 69 | ticks v|alues wi|
|00003410| 6c 6c 20 73 70 65 65 64 | 20 75 70 20 74 68 65 20 |ll speed| up the |
|00003420| 0d 20 20 74 63 6c 20 73 | 63 72 69 70 74 20 61 74 |.  tcl s|cript at|
|00003430| 20 74 68 65 20 65 78 70 | 65 6e 73 65 20 6f 74 68 | the exp|ense oth|
|00003440| 65 72 20 70 72 6f 67 72 | 61 6d 73 20 67 65 74 74 |er progr|ams gett|
|00003450| 69 6e 67 20 6c 65 73 73 | 20 6f 66 20 74 68 65 20 |ing less| of the |
|00003460| 43 50 55 2e 0d 0d 73 74 | 61 72 74 5f 70 72 6f 67 |CPU...st|art_prog|
|00003470| 72 65 73 73 20 74 69 74 | 6c 65 20 73 74 61 72 74 |ress tit|le start|
|00003480| 20 65 6e 64 20 70 6f 73 | 20 6d 73 67 65 78 70 72 | end pos| msgexpr|
|00003490| 63 20 2a 2a 2a 20 4e 4f | 54 20 59 45 54 20 49 4e |c *** NO|T YET IN|
|000034a0| 43 4f 52 50 4f 52 41 54 | 45 44 20 49 4e 54 4f 20 |CORPORAT|ED INTO |
|000034b0| 41 4c 50 48 41 20 2a 2a | 2a 0d 20 20 54 68 69 73 |ALPHA **|*.  This|
|000034c0| 20 77 69 6c 6c 20 64 69 | 73 70 6c 61 79 20 61 20 | will di|splay a |
|000034d0| 73 6d 61 6c 6c 20 77 69 | 6e 64 6f 77 20 69 6e 20 |small wi|ndow in |
|000034e0| 77 68 69 63 68 20 61 20 | 73 6c 69 64 69 6e 67 20 |which a |sliding |
|000034f0| 62 61 72 20 70 72 6f 67 | 72 65 73 73 20 69 6e 64 |bar prog|ress ind|
|00003500| 69 63 61 74 6f 72 20 77 | 69 6c 6c 20 62 65 20 0d |icator w|ill be .|
|00003510| 20 20 64 69 73 70 6c 61 | 79 65 64 2e 20 54 68 65 |  displa|yed. The|
|00003520| 20 74 69 74 6c 65 20 77 | 69 6c 6c 20 62 65 20 74 | title w|ill be t|
|00003530| 68 65 20 77 69 6e 64 6f | 77 20 74 69 74 6c 65 2e |he windo|w title.|
|00003540| 20 53 74 61 72 74 61 6e | 64 20 65 6e 64 ca 61 72 | Startan|d end.ar|
|00003550| 65 20 74 68 65 20 65 6e | 64 20 70 6f 69 6e 74 73 |e the en|d points|
|00003560| 20 6f 66 20 74 68 65 20 | 0d 20 20 70 72 6f 67 72 | of the |.  progr|
|00003570| 65 73 73 20 69 6e 64 69 | 63 61 74 6f 72 2c 20 61 |ess indi|cator, a|
|00003580| 6e 64 20 70 6f 73 20 69 | 73 20 74 68 65 20 69 6e |nd pos i|s the in|
|00003590| 69 74 69 61 6c 20 70 6f | 73 69 74 69 6f 6e 20 6f |itial po|sition o|
|000035a0| 66 20 74 68 65 20 69 6e | 64 69 63 61 74 6f 72 20 |f the in|dicator |
|000035b0| 61 6e 64 20 6d 75 73 74 | 20 62 65 20 0d 20 20 62 |and must| be .  b|
|000035c0| 65 74 77 65 65 6e 20 73 | 74 61 72 74 20 61 6e 64 |etween s|tart and|
|000035d0| 20 65 6e 64 2e 20 4d 73 | 67 65 78 70 72 20 69 73 | end. Ms|gexpr is|
|000035e0| 20 61 20 74 69 63 6b 6c | 65 20 65 78 70 72 65 73 | a tickl|e expres|
|000035f0| 73 69 6f 6e 20 74 68 61 | 74 20 77 69 6c 6c 20 62 |sion tha|t will b|
|00003600| 65 20 65 76 61 6c 75 61 | 74 65 64 20 65 61 63 68 |e evalua|ted each|
|00003610| 20 0d 20 20 74 69 6d 65 | 20 74 68 65 20 70 6f 73 | .  time| the pos|
|00003620| 69 74 69 6f 6e 20 69 73 | 20 75 70 64 61 74 65 64 |ition is| updated|
|00003630| 20 62 79 20 74 68 65 20 | 75 70 64 61 74 65 5f 70 | by the |update_p|
|00003640| 72 6f 67 72 65 73 73 20 | 66 75 6e 63 74 69 6f 6e |rogress |function|
|00003650| 2e 20 54 68 65 20 72 65 | 73 75 6c 74 20 6f 66 20 |. The re|sult of |
|00003660| 74 68 69 73 20 0d 20 20 | 65 78 70 72 65 73 73 69 |this .  |expressi|
|00003670| 6f 6e 20 77 69 6c 6c 20 | 62 65 20 64 69 73 70 6c |on will |be displ|
|00003680| 61 79 65 64 20 69 6e 20 | 74 68 65 20 70 72 6f 67 |ayed in |the prog|
|00003690| 72 65 73 73 20 77 69 6e | 64 6f 77 20 61 73 20 74 |ress win|dow as t|
|000036a0| 68 65 20 70 72 6f 67 72 | 65 73 73 20 6d 65 73 73 |he progr|ess mess|
|000036b0| 61 67 65 2c 20 61 6e 64 | 20 0d 20 20 74 68 75 73 |age, and| .  thus|
|000036c0| 20 77 69 6c 6c 20 6d 6f | 73 74 20 6c 69 6b 65 6c | will mo|st likel|
|000036d0| 79 20 62 65 20 74 68 65 | 20 66 6f 72 6d 61 74 20 |y be the| format |
|000036e0| 63 6f 6d 6d 61 6e 64 2e | 0d 0d 75 70 64 61 74 65 |command.|..update|
|000036f0| 5f 70 72 6f 67 72 65 73 | 73 20 70 6f 73 69 74 69 |_progres|s positi|
|00003700| 6f 6e 20 2a 2a 2a 20 4e | 4f 54 20 59 45 54 20 49 |on *** N|OT YET I|
|00003710| 4e 43 4f 52 50 4f 52 41 | 54 45 44 20 49 4e 54 4f |NCORPORA|TED INTO|
|00003720| 20 41 4c 50 48 41 20 2a | 2a 2a 0d 20 20 54 68 69 | ALPHA *|**.  Thi|
|00003730| 73 20 77 69 6c 6c 20 75 | 70 64 61 74 65 20 74 68 |s will u|pdate th|
|00003740| 65 20 70 72 6f 67 72 65 | 73 73 20 69 6e 64 69 63 |e progre|ss indic|
|00003750| 61 74 6f 72 20 74 6f 20 | 73 68 6f 77 20 70 72 6f |ator to |show pro|
|00003760| 67 72 65 73 73 20 74 6f | 20 70 6f 73 69 74 69 6f |gress to| positio|
|00003770| 6e 2e 0d 0d 73 74 6f 70 | 5f 70 72 6f 67 72 65 73 |n...stop|_progres|
|00003780| 73 20 2a 2a 2a 20 4e 4f | 54 20 59 45 54 20 49 4e |s *** NO|T YET IN|
|00003790| 43 4f 52 50 4f 52 41 54 | 45 44 20 49 4e 54 4f 20 |CORPORAT|ED INTO |
|000037a0| 41 4c 50 48 41 20 2a 2a | 2a 0d 20 20 54 68 69 73 |ALPHA **|*.  This|
|000037b0| 20 77 69 6c 6c 20 63 6c | 6f 73 65 20 74 68 65 20 | will cl|ose the |
|000037c0| 70 72 6f 67 72 65 73 73 | 20 69 6e 64 69 63 61 74 |progress| indicat|
|000037d0| 6f 72 20 77 69 6e 64 6f | 77 2e 0d 0d 6c 6f 67 67 |or windo|w...logg|
|000037e0| 69 6e 67 20 6f 6e 7c 6f | 66 66 20 3f 66 69 6c 65 |ing on|o|ff ?file|
|000037f0| 6e 61 6d 65 3f 20 2a 2a | 2a 20 4e 4f 54 20 59 45 |name? **|* NOT YE|
|00003800| 54 20 49 4e 43 4f 52 50 | 4f 52 41 54 45 44 20 49 |T INCORP|ORATED I|
|00003810| 4e 54 4f 20 41 4c 50 48 | 41 20 2a 2a 2a 0d 20 20 |NTO ALPH|A ***.  |
|00003820| 54 68 69 73 20 77 69 6c | 6c 20 74 75 72 6e 20 74 |This wil|l turn t|
|00003830| 68 65 20 74 69 63 6b 6c | 65 20 6c 6f 67 67 69 6e |he tickl|e loggin|
|00003840| 67 20 6f 6e 20 6f 72 20 | 6f 66 66 2e 20 49 66 20 |g on or |off. If |
|00003850| 66 69 6c 65 6e 61 6d 65 | 20 69 73 20 70 72 6f 76 |filename| is prov|
|00003860| 69 64 65 64 20 77 69 74 | 68 20 74 68 65 20 6f 6e |ided wit|h the on|
|00003870| 20 0d 20 20 6f 70 74 69 | 6f 6e 2c 20 74 68 65 6e | .  opti|on, then|
|00003880| 20 74 68 65 20 6c 6f 67 | 20 66 69 6c 65 20 77 69 | the log| file wi|
|00003890| 6c 6c 20 62 65 20 63 68 | 61 6e 67 65 64 20 6f 76 |ll be ch|anged ov|
|000038a0| 65 72 20 74 6f 20 75 73 | 69 6e 67 20 74 68 65 20 |er to us|ing the |
|000038b0| 66 69 6c 65 20 6e 61 6d | 65 64 2e 0d 0d 2a 2a 2a |file nam|ed...***|
|000038c0| 20 4d 4f 52 45 20 45 58 | 54 45 4e 53 49 4f 4e 53 | MORE EX|TENSIONS|
|000038d0| 20 2a 2a 2a 0d 0d 4d 61 | 6e 79 20 65 78 74 65 6e | ***..Ma|ny exten|
|000038e0| 73 69 6f 6e 73 20 74 6f | 20 74 69 63 6b 6c 65 20 |sions to| tickle |
|000038f0| 77 65 72 65 20 70 72 6f | 76 69 64 65 64 20 62 79 |were pro|vided by|
|00003900| 20 4b 61 72 6c 20 4c 65 | 68 65 6e 62 61 75 65 72 | Karl Le|henbauer|
|00003910| 20 61 6e 64 20 4d 61 72 | 6b 20 44 69 65 6b 68 61 | and Mar|k Diekha|
|00003920| 6e 73 2e 20 0d 54 68 65 | 20 6d 6f 73 74 20 62 65 |ns. .The| most be|
|00003930| 6e 65 66 69 63 69 61 6c | 20 6f 66 20 74 68 6f 73 |neficial| of thos|
|00003940| 65 20 66 6f 72 20 74 69 | 63 6b 6c 65 20 77 65 72 |e for ti|ckle wer|
|00003950| 65 20 69 6e 63 6c 75 64 | 65 64 2e 20 54 68 65 73 |e includ|ed. Thes|
|00003960| 65 20 69 6e 63 6c 75 64 | 65 64 20 6d 61 74 68 20 |e includ|ed math |
|00003970| 61 6e 64 20 0d 73 74 72 | 69 6e 67 20 66 75 6e 63 |and .str|ing func|
|00003980| 74 69 6f 6e 73 2c 20 61 | 73 20 77 65 6c 6c 20 61 |tions, a|s well a|
|00003990| 73 20 61 20 6e 65 61 74 | 20 6e 65 77 20 6c 6f 6f |s a neat| new loo|
|000039a0| 70 20 63 6f 6d 6d 61 6e | 64 2e 20 54 68 65 20 6d |p comman|d. The m|
|000039b0| 61 6e 20 70 61 67 65 73 | 20 61 72 65 20 69 6e 63 |an pages| are inc|
|000039c0| 6c 75 64 65 64 20 0d 66 | 6f 72 20 73 6f 6d 65 20 |luded .f|or some |
|000039d0| 6f 66 20 74 68 65 73 65 | 20 63 6f 6d 6d 61 6e 64 |of these| command|
|000039e0| 73 2c 20 62 75 74 20 68 | 65 72 65 20 69 73 20 61 |s, but h|ere is a|
|000039f0| 20 62 72 69 65 66 20 73 | 75 6d 6d 61 72 79 2e 0d | brief s|ummary..|
|00003a00| 54 68 65 72 65 20 61 72 | 65 20 6d 61 74 68 20 66 |There ar|e math f|
|00003a10| 75 6e 63 74 69 6f 6e 73 | 3a 0d 09 61 63 6f 73 09 |unctions|:..acos.|
|00003a20| 61 73 69 6e 09 61 74 61 | 6e 09 63 6f 73 09 73 69 |asin.ata|n.cos.si|
|00003a30| 6e 09 74 61 6e 09 63 6f | 73 68 09 73 69 6e 68 09 |n.tan.co|sh.sinh.|
|00003a40| 74 61 6e 68 0d 09 65 78 | 70 09 6c 6f 67 09 6c 6f |tanh..ex|p.log.lo|
|00003a50| 67 31 30 09 73 71 72 74 | 09 66 61 62 73 09 66 6c |g10.sqrt|.fabs.fl|
|00003a60| 6f 6f 72 09 63 65 69 6c | 09 66 6d 6f 64 09 70 6f |oor.ceil|.fmod.po|
|00003a70| 77 0d 54 68 65 20 74 72 | 69 67 20 66 75 6e 63 74 |w.The tr|ig funct|
|00003a80| 69 6f 6e 73 20 77 6f 72 | 6b 20 77 69 74 68 20 72 |ions wor|k with r|
|00003a90| 61 64 69 61 6e 73 2e 0d | 54 68 65 20 66 75 6e 63 |adians..|The func|
|00003aa0| 74 69 6f 6e 20 70 69 20 | 77 69 6c 6c 20 73 69 6d |tion pi |will sim|
|00003ab0| 70 6c 79 20 72 65 74 75 | 72 6e 20 74 68 65 20 63 |ply retu|rn the c|
|00003ac0| 6f 6e 73 74 61 6e 74 2e | 0d 54 68 65 20 66 75 6e |onstant.|.The fun|
|00003ad0| 63 74 69 6f 6e 73 20 6d | 61 78 20 61 6e 64 20 6d |ctions m|ax and m|
|00003ae0| 69 6e 20 77 69 6c 6c 20 | 77 6f 72 6b 20 6f 6e 20 |in will |work on |
|00003af0| 6c 69 73 74 73 20 6f 66 | 20 66 6c 6f 61 74 69 6e |lists of| floatin|
|00003b00| 67 20 70 6f 69 6e 74 20 | 6e 75 6d 62 65 72 73 2e |g point |numbers.|
|00003b10| 0d 54 68 65 20 66 75 6e | 63 74 69 6f 6e 20 72 61 |.The fun|ction ra|
|00003b20| 6e 64 6f 6d 20 20 6c 69 | 6d 69 74 20 77 69 6c 6c |ndom  li|mit will|
|00003b30| 20 72 65 74 75 72 6e 20 | 61 20 72 61 6e 64 6f 6d | return |a random|
|00003b40| 20 6e 75 6d 62 65 72 20 | 62 65 74 77 65 65 6e 20 | number |between |
|00003b50| 2b 20 61 6e 64 20 2d 20 | 6c 69 6d 69 74 2e 0d 54 |+ and - |limit..T|
|00003b60| 68 65 20 66 75 6e 63 74 | 69 6f 6e 20 72 61 6e 64 |he funct|ion rand|
|00003b70| 6f 6d 20 73 65 65 64 20 | 5b 73 65 65 64 76 61 6c |om seed |[seedval|
|00003b80| 5d 20 77 69 6c 6c 20 73 | 65 74 20 74 68 65 20 73 |] will s|et the s|
|00003b90| 65 65 64 20 66 6f 72 20 | 74 68 65 20 72 61 6e 64 |eed for |the rand|
|00003ba0| 6f 6d 20 66 75 6e 63 74 | 69 6f 6e 20 74 6f 20 0d |om funct|ion to .|
|00003bb0| 73 65 65 64 76 61 6c 2c | 20 6f 72 20 74 6f 20 74 |seedval,| or to t|
|00003bc0| 68 65 20 63 75 72 72 65 | 6e 74 20 74 69 6d 65 20 |he curre|nt time |
|00003bd0| 69 66 20 73 65 65 64 76 | 61 6c 20 69 73 20 6e 6f |if seedv|al is no|
|00003be0| 74 20 70 72 6f 76 69 64 | 65 64 2e 0d 0d 54 68 65 |t provid|ed...The|
|00003bf0| 20 66 75 6e 63 74 69 6f | 6e 20 6c 6f 6f 70 20 76 | functio|n loop v|
|00003c00| 61 72 6e 61 6d 65 20 73 | 74 61 72 74 20 65 6e 64 |arname s|tart end|
|00003c10| 20 69 6e 63 72 65 6d 65 | 6e 74 20 65 78 70 72 20 | increme|nt expr |
|00003c20| 77 69 6c 6c 20 69 6e 63 | 72 65 6d 65 6e 74 20 74 |will inc|rement t|
|00003c30| 68 65 20 76 61 72 69 61 | 62 6c 65 20 0d 76 61 72 |he varia|ble .var|
|00003c40| 6e 61 6d 65 20 66 72 6f | 6d 20 73 74 61 72 74 20 |name fro|m start |
|00003c50| 74 6f 20 65 6e 64 20 62 | 79 20 69 6e 63 72 65 6d |to end b|y increm|
|00003c60| 65 6e 74 20 77 68 69 6c | 65 20 65 78 65 63 75 74 |ent whil|e execut|
|00003c70| 69 6e 67 20 65 78 70 72 | 20 66 6f 72 20 65 61 63 |ing expr| for eac|
|00003c80| 68 20 69 6e 63 72 65 6d | 65 6e 74 2e 0d 0d 2a 2a |h increm|ent...**|
|00003c90| 2a 20 41 70 70 6c 65 20 | 45 76 65 6e 74 20 54 43 |* Apple |Event TC|
|00003ca0| 4c 20 45 78 74 65 6e 73 | 69 6f 6e 73 20 2a 2a 2a |L Extens|ions ***|
|00003cb0| 20 4e 4f 54 20 59 45 54 | 20 49 4e 43 4f 52 50 4f | NOT YET| INCORPO|
|00003cc0| 52 41 54 45 44 20 49 4e | 54 4f 20 41 4c 50 48 41 |RATED IN|TO ALPHA|
|00003cd0| 20 2a 2a 2a 0d 0d 54 68 | 69 73 20 69 6d 70 6c 65 | ***..Th|is imple|
|00003ce0| 6d 65 6e 74 61 74 69 6f | 6e 20 6f 66 20 74 69 63 |mentatio|n of tic|
|00003cf0| 6b 6c 65 20 68 61 73 20 | 65 78 74 65 6e 73 69 76 |kle has |extensiv|
|00003d00| 65 20 73 75 70 70 6f 72 | 74 20 66 6f 72 20 41 70 |e suppor|t for Ap|
|00003d10| 70 6c 65 20 45 76 65 6e | 74 73 2e 20 54 68 69 73 |ple Even|ts. This|
|00003d20| 20 0d 69 6e 63 6c 75 64 | 65 73 20 62 6f 74 68 20 | .includ|es both |
|00003d30| 73 75 70 70 6f 72 74 20 | 6f 66 20 74 68 65 20 73 |support |of the s|
|00003d40| 74 61 6e 64 61 72 64 20 | 73 75 69 74 65 20 6f 66 |tandard |suite of|
|00003d50| 20 65 76 65 6e 74 73 2c | 20 61 73 20 77 65 6c 6c | events,| as well|
|00003d60| 20 61 73 20 73 75 70 70 | 6f 72 74 20 66 6f 72 20 | as supp|ort for |
|00003d70| 0d 73 63 72 69 70 74 20 | 65 76 65 6e 74 73 2c 20 |.script |events, |
|00003d80| 69 6e 73 74 61 6c 6c 69 | 6e 67 20 79 6f 75 72 20 |installi|ng your |
|00003d90| 6f 77 6e 20 63 6f 65 72 | 63 69 6f 6e 20 61 6e 64 |own coer|cion and|
|00003da0| 20 65 76 65 6e 74 20 68 | 61 6e 64 6c 69 6e 67 20 | event h|andling |
|00003db0| 72 6f 75 74 69 6e 65 73 | 2c 20 61 73 20 0d 77 65 |routines|, as .we|
|00003dc0| 6c 6c 20 61 73 20 74 68 | 65 20 61 62 69 6c 69 74 |ll as th|e abilit|
|00003dd0| 79 20 74 6f 20 73 65 6e | 64 20 41 70 70 6c 65 20 |y to sen|d Apple |
|00003de0| 45 76 65 6e 74 73 20 74 | 6f 20 6f 74 68 65 72 20 |Events t|o other |
|00003df0| 70 72 6f 63 65 73 73 65 | 73 2e 0d 0d 54 69 63 6b |processe|s...Tick|
|00003e00| 6c 65 20 73 75 70 70 6f | 72 74 73 20 74 68 65 20 |le suppo|rts the |
|00003e10| 27 6d 69 73 63 27 20 27 | 64 6f 73 63 27 20 41 70 |'misc' '|dosc' Ap|
|00003e20| 70 6c 65 20 45 76 65 6e | 74 2c 20 6f 74 68 65 72 |ple Even|t, other|
|00003e30| 77 69 73 65 20 6b 6e 6f | 77 6e 20 61 73 20 0d 44 |wise kno|wn as .D|
|00003e40| 6f 53 63 72 69 70 74 2e | 20 20 46 75 72 74 68 65 |oScript.|  Furthe|
|00003e50| 72 2c 20 74 69 63 6b 6c | 65 20 73 75 70 70 6f 72 |r, tickl|e suppor|
|00003e60| 74 73 20 62 6f 74 68 20 | 74 68 65 20 74 79 70 65 |ts both |the type|
|00003e70| 43 68 61 72 20 61 6e 64 | 20 74 79 70 65 41 6c 69 |Char and| typeAli|
|00003e80| 61 73 20 66 6f 72 6d 73 | 20 6f 66 20 0d 69 6e 70 |as forms| of .inp|
|00003e90| 75 74 20 74 6f 20 74 68 | 65 20 44 6f 53 63 72 69 |ut to th|e DoScri|
|00003ea0| 70 74 20 65 76 65 6e 74 | 2e 20 46 6f 72 20 74 68 |pt event|. For th|
|00003eb0| 65 20 74 79 70 65 43 68 | 61 72 20 66 6f 72 6d 2c |e typeCh|ar form,|
|00003ec0| 20 74 68 65 20 74 65 78 | 74 20 77 69 6c 6c 20 62 | the tex|t will b|
|00003ed0| 65 20 0d 63 6f 6e 73 69 | 64 65 72 65 64 20 61 20 |e .consi|dered a |
|00003ee0| 73 63 72 69 70 74 20 61 | 6e 64 20 65 78 65 63 75 |script a|nd execu|
|00003ef0| 74 65 64 2e 20 46 6f 72 | 20 74 68 65 20 74 79 70 |ted. For| the typ|
|00003f00| 65 41 6c 69 61 73 20 66 | 6f 72 6d 2c 20 74 68 65 |eAlias f|orm, the|
|00003f10| 20 66 69 6c 65 20 0d 72 | 65 70 72 65 73 65 6e 74 | file .r|epresent|
|00003f20| 65 64 20 62 79 20 74 68 | 65 20 61 6c 69 61 73 20 |ed by th|e alias |
|00003f30| 77 69 6c 6c 20 62 65 20 | 65 78 65 63 75 74 65 64 |will be |executed|
|00003f40| 2e 20 49 6e 20 65 69 74 | 68 65 72 20 63 61 73 65 |. In eit|her case|
|00003f50| 2c 20 74 68 65 20 72 65 | 73 75 6c 74 20 77 69 6c |, the re|sult wil|
|00003f60| 6c 20 62 65 20 0d 72 65 | 74 75 72 6e 65 64 20 76 |l be .re|turned v|
|00003f70| 69 61 20 74 68 65 20 72 | 65 70 6c 79 20 61 73 20 |ia the r|eply as |
|00003f80| 74 79 70 65 43 68 61 72 | 2e 20 54 68 65 20 73 63 |typeChar|. The sc|
|00003f90| 72 69 70 74 20 77 69 6c | 6c 20 61 6c 77 61 79 73 |ript wil|l always|
|00003fa0| 20 62 65 20 65 78 65 63 | 75 74 65 64 20 69 6e 20 | be exec|uted in |
|00003fb0| 0d 74 68 65 20 63 6f 6e | 74 65 78 74 20 6f 66 20 |.the con|text of |
|00003fc0| 74 68 65 20 67 6c 6f 62 | 61 6c 20 69 6e 74 65 72 |the glob|al inter|
|00003fd0| 70 72 65 74 65 72 2e 0d | 0d 54 69 63 6b 6c 65 20 |preter..|.Tickle |
|00003fe0| 61 6c 73 6f 20 61 6c 6c | 6f 77 73 20 79 6f 75 20 |also all|ows you |
|00003ff0| 74 6f 20 69 6e 73 74 61 | 6c 6c 20 41 70 70 6c 65 |to insta|ll Apple|
|00004000| 20 45 76 65 6e 74 20 68 | 61 6e 64 6c 65 72 73 20 | Event h|andlers |
|00004010| 76 69 61 20 74 68 65 20 | 61 65 6c 6f 61 64 20 0d |via the |aeload .|
|00004020| 63 6f 6d 6d 61 6e 64 20 | 64 65 73 63 72 69 62 65 |command |describe|
|00004030| 64 20 62 65 6c 6f 77 2e | 20 54 68 69 73 20 77 69 |d below.| This wi|
|00004040| 6c 6c 20 69 6e 73 74 61 | 6c 6c 20 73 74 61 6e 64 |ll insta|ll stand|
|00004050| 20 61 6c 6f 6e 65 20 63 | 6f 64 65 20 6d 6f 64 75 | alone c|ode modu|
|00004060| 6c 65 73 20 74 6f 20 0d | 68 61 6e 64 6c 65 20 41 |les to .|handle A|
|00004070| 70 70 6c 65 20 45 76 65 | 6e 74 73 2e 20 54 68 65 |pple Eve|nts. The|
|00004080| 20 72 65 66 43 6f 6e 20 | 74 6f 20 74 68 65 73 65 | refCon |to these|
|00004090| 20 68 61 6e 64 6c 65 72 | 73 20 77 69 6c 6c 20 70 | handler|s will p|
|000040a0| 6f 69 6e 74 20 74 6f 20 | 61 20 73 74 72 75 63 74 |oint to |a struct|
|000040b0| 20 0d 74 68 61 74 20 67 | 69 76 65 73 20 79 6f 75 | .that g|ives you|
|000040c0| 20 74 68 65 20 69 6e 74 | 65 72 70 72 65 74 65 72 | the int|erpreter|
|000040d0| 20 70 6f 69 6e 74 65 72 | 20 74 6f 20 74 68 65 20 | pointer| to the |
|000040e0| 67 6c 6f 62 61 6c 20 74 | 63 6c 20 69 6e 74 65 72 |global t|cl inter|
|000040f0| 70 72 65 74 65 72 2c 20 | 61 73 20 77 65 6c 6c 20 |preter, |as well |
|00004100| 61 73 20 0d 61 20 70 72 | 6f 63 65 64 75 72 65 20 |as .a pr|ocedure |
|00004110| 74 6f 20 6d 61 6b 65 20 | 69 74 20 65 61 73 79 20 |to make |it easy |
|00004120| 66 6f 72 20 79 6f 75 20 | 74 6f 20 6d 61 6b 65 20 |for you |to make |
|00004130| 63 61 6c 6c 73 20 62 61 | 63 6b 20 74 6f 20 74 68 |calls ba|ck to th|
|00004140| 65 20 74 63 6c 20 69 6e | 74 65 72 70 72 65 74 65 |e tcl in|terprete|
|00004150| 72 20 0d 77 69 74 68 6f | 75 74 20 6c 69 6e 6b 69 |r .witho|ut linki|
|00004160| 6e 67 20 69 6e 20 74 68 | 65 20 74 63 6c 20 6c 69 |ng in th|e tcl li|
|00004170| 62 72 61 72 69 65 73 20 | 69 6e 20 79 6f 75 72 20 |braries |in your |
|00004180| 68 61 6e 64 6c 65 72 2e | 20 54 68 65 20 61 65 6c |handler.| The ael|
|00004190| 6f 61 64 20 63 6f 6d 6d | 61 6e 64 20 0d 77 69 6c |oad comm|and .wil|
|000041a0| 6c 20 61 6c 73 6f 20 6c | 6f 61 64 20 63 6f 65 72 |l also l|oad coer|
|000041b0| 63 69 6f 6e 20 68 61 6e | 64 6c 65 72 73 2e 20 46 |cion han|dlers. F|
|000041c0| 6f 72 20 6d 6f 72 65 20 | 64 65 74 61 69 6c 73 20 |or more |details |
|000041d0| 6f 6e 20 77 72 69 74 69 | 6e 67 20 61 6e 20 41 70 |on writi|ng an Ap|
|000041e0| 70 6c 65 20 0d 45 76 65 | 6e 74 20 68 61 6e 64 6c |ple .Eve|nt handl|
|000041f0| 65 72 20 6f 72 20 61 20 | 63 6f 65 72 63 69 6f 6e |er or a |coercion|
|00004200| 20 70 72 6f 63 65 64 75 | 72 65 2c 20 73 65 65 20 | procedu|re, see |
|00004210| 74 68 65 20 65 78 61 6d | 70 6c 65 20 73 6f 75 72 |the exam|ple sour|
|00004220| 63 65 73 20 69 6e 63 6c | 75 64 65 64 2e 0d 0d 54 |ces incl|uded...T|
|00004230| 68 65 20 6c 6f 61 64 65 | 64 20 63 6f 64 65 20 72 |he loade|d code r|
|00004240| 65 73 6f 75 72 63 65 73 | 20 61 72 65 20 73 69 6d |esources| are sim|
|00004250| 70 6c 79 20 63 6f 64 65 | 20 72 65 73 6f 75 72 63 |ply code| resourc|
|00004260| 65 73 20 77 69 74 68 20 | 73 70 65 63 69 61 6c 20 |es with |special |
|00004270| 6e 61 6d 65 73 20 0d 74 | 68 61 74 20 69 6e 64 69 |names .t|hat indi|
|00004280| 63 61 74 65 20 74 68 65 | 69 72 20 62 65 68 61 76 |cate the|ir behav|
|00004290| 69 6f 72 2e 20 54 68 65 | 20 66 69 72 73 74 20 34 |ior. The| first 4|
|000042a0| 20 63 68 61 72 61 63 74 | 65 72 73 20 28 71 75 61 | charact|ers (qua|
|000042b0| 72 74 65 74 20 29 20 6f | 66 20 74 68 65 20 6e 61 |rtet ) o|f the na|
|000042c0| 6d 65 20 0d 64 65 74 65 | 72 6d 69 6e 65 20 74 68 |me .dete|rmine th|
|000042d0| 65 20 63 6f 64 65 20 74 | 79 70 65 3a 0d 0d 41 45 |e code t|ype:..AE|
|000042e0| 56 54 09 41 70 70 6c 65 | 20 45 76 65 6e 74 20 48 |VT.Apple| Event H|
|000042f0| 61 6e 64 6c 65 72 2e 0d | 43 53 50 54 09 50 6f 69 |andler..|CSPT.Poi|
|00004300| 6e 74 65 72 20 62 61 73 | 65 64 20 63 6f 65 72 63 |nter bas|ed coerc|
|00004310| 69 6f 6e 20 68 61 6e 64 | 6c 65 72 2e 0d 43 53 44 |ion hand|ler..CSD|
|00004320| 53 09 41 45 44 65 73 63 | 20 62 61 73 65 64 20 63 |S.AEDesc| based c|
|00004330| 6f 65 72 63 69 6f 6e 20 | 68 61 6e 64 6c 65 72 2e |oercion |handler.|
|00004340| 0d 0d 46 6f 72 20 41 45 | 56 54 20 72 65 73 6f 75 |..For AE|VT resou|
|00004350| 72 63 65 73 2c 20 74 68 | 65 20 73 65 63 6f 6e 64 |rces, th|e second|
|00004360| 20 71 75 61 72 74 65 74 | 20 6f 66 20 63 68 61 72 | quartet| of char|
|00004370| 61 63 74 65 72 73 20 69 | 6e 20 74 68 65 20 6e 61 |acters i|n the na|
|00004380| 6d 65 20 0d 72 65 70 72 | 65 73 65 6e 74 20 74 68 |me .repr|esent th|
|00004390| 65 20 65 76 65 6e 74 20 | 63 6c 61 73 73 20 61 6e |e event |class an|
|000043a0| 64 20 74 68 65 20 74 68 | 69 72 64 20 71 75 61 72 |d the th|ird quar|
|000043b0| 74 65 74 20 6f 66 20 63 | 68 61 72 61 63 74 65 72 |tet of c|haracter|
|000043c0| 73 20 69 6e 20 74 68 65 | 20 6e 61 6d 65 20 0d 72 |s in the| name .r|
|000043d0| 65 70 72 65 73 65 6e 74 | 20 74 68 65 20 65 76 65 |epresent| the eve|
|000043e0| 6e 74 20 49 44 2e 0d 0d | 46 6f 72 20 43 53 50 54 |nt ID...|For CSPT|
|000043f0| 20 61 6e 64 20 43 53 44 | 53 20 72 65 73 6f 75 72 | and CSD|S resour|
|00004400| 63 65 73 2c 20 74 68 65 | 20 73 65 63 6f 6e 64 20 |ces, the| second |
|00004410| 71 75 61 72 74 65 74 20 | 6f 66 20 63 68 61 72 61 |quartet |of chara|
|00004420| 63 74 65 72 73 20 69 6e | 20 74 68 65 20 0d 6e 61 |cters in| the .na|
|00004430| 6d 65 20 72 65 70 72 65 | 73 65 6e 74 20 74 68 65 |me repre|sent the|
|00004440| 20 64 65 73 63 72 69 70 | 74 6f 72 20 74 79 70 65 | descrip|tor type|
|00004450| 20 6f 66 20 74 68 65 20 | 69 6e 63 6f 6d 69 6e 67 | of the |incoming|
|00004460| 20 64 61 74 61 20 28 69 | 2e 65 2e 2c 20 74 68 65 | data (i|.e., the|
|00004470| 20 66 72 6f 6d 20 74 79 | 70 65 29 20 0d 61 6e 64 | from ty|pe) .and|
|00004480| 20 74 68 65 20 74 68 69 | 72 64 20 71 75 61 72 74 | the thi|rd quart|
|00004490| 65 74 20 6f 66 20 63 68 | 61 72 61 63 74 65 72 73 |et of ch|aracters|
|000044a0| 20 69 6e 20 74 68 65 20 | 6e 61 6d 65 20 72 65 70 | in the |name rep|
|000044b0| 72 65 73 65 6e 74 20 74 | 68 65 20 64 65 73 63 72 |resent t|he descr|
|000044c0| 69 70 74 6f 72 20 0d 74 | 79 70 65 20 6f 66 20 74 |iptor .t|ype of t|
|000044d0| 68 65 20 64 65 73 69 72 | 65 64 20 63 6f 65 72 63 |he desir|ed coerc|
|000044e0| 69 6f 6e 20 28 69 2e 65 | 2e 2c 20 74 68 65 20 74 |ion (i.e|., the t|
|000044f0| 6f 20 74 79 70 65 29 2e | 0d 0d 53 65 76 65 72 61 |o type).|..Severa|
|00004500| 6c 20 63 6f 6d 6d 61 6e | 64 73 20 68 61 76 65 20 |l comman|ds have |
|00004510| 62 65 65 6e 20 61 64 64 | 65 64 20 74 6f 20 74 68 |been add|ed to th|
|00004520| 65 20 74 63 6c 20 6c 61 | 6e 67 75 61 67 65 20 74 |e tcl la|nguage t|
|00004530| 6f 20 66 61 63 69 6c 69 | 74 61 74 65 20 74 68 65 |o facili|tate the|
|00004540| 20 0d 73 65 6e 64 69 6e | 67 20 6f 66 20 41 70 70 | .sendin|g of App|
|00004550| 6c 65 20 45 76 65 6e 74 | 73 20 74 6f 20 6f 74 68 |le Event|s to oth|
|00004560| 65 72 20 68 6f 73 74 73 | 2e 20 54 68 65 79 20 61 |er hosts|. They a|
|00004570| 72 65 20 69 74 65 6d 69 | 7a 65 64 20 68 65 72 65 |re itemi|zed here|
|00004580| 3a 0d 0d 61 65 6f 70 65 | 6e 20 6e 61 6d 65 20 5b |:..aeope|n name [|
|00004590| 41 70 70 6c 53 69 67 20 | 7c 20 70 6f 72 74 5f 6e |ApplSig || port_n|
|000045a0| 61 6d 65 20 6c 6f 63 61 | 74 69 6f 6e 5f 6e 61 6d |ame loca|tion_nam|
|000045b0| 65 5d 0d 0d 54 68 69 73 | 20 63 6f 6d 6d 61 6e 64 |e]..This| command|
|000045c0| 20 63 72 65 61 74 65 73 | 20 61 20 6e 61 6d 65 64 | creates| a named|
|000045d0| 20 63 6f 6e 6e 65 63 74 | 69 6f 6e 20 77 69 74 68 | connect|ion with|
|000045e0| 20 77 68 69 63 68 20 79 | 6f 75 20 63 61 6e 20 73 | which y|ou can s|
|000045f0| 65 6e 64 20 41 70 70 6c | 65 20 45 76 65 6e 74 73 |end Appl|e Events|
|00004600| 20 0d 74 6f 20 6f 74 68 | 65 72 20 70 72 6f 63 65 | .to oth|er proce|
|00004610| 73 73 65 73 2e 20 49 66 | 20 74 68 65 20 41 70 70 |sses. If| the App|
|00004620| 6c 53 69 67 20 70 61 72 | 61 6d 65 74 65 72 20 69 |lSig par|ameter i|
|00004630| 73 20 70 72 65 73 65 6e | 74 2c 20 74 68 65 6e 20 |s presen|t, then |
|00004640| 74 68 65 20 74 61 72 67 | 65 74 20 77 69 6c 6c 20 |the targ|et will |
|00004650| 62 65 20 74 68 65 20 0d | 6c 6f 63 61 6c 20 61 70 |be the .|local ap|
|00004660| 70 6c 69 63 61 74 69 6f | 6e 20 77 69 74 68 20 74 |plicatio|n with t|
|00004670| 68 65 20 73 70 65 63 69 | 66 69 65 64 20 66 6f 75 |he speci|fied fou|
|00004680| 72 20 63 68 61 72 61 63 | 74 65 72 20 73 69 67 6e |r charac|ter sign|
|00004690| 61 74 75 72 65 2e 0d 49 | 66 20 74 68 65 20 70 6f |ature..I|f the po|
|000046a0| 72 74 5f 6e 61 6d 65 20 | 6c 6f 63 61 74 69 6f 6e |rt_name |location|
|000046b0| 5f 6e 61 6d 65 20 70 61 | 72 61 6d 65 74 65 72 73 |_name pa|rameters|
|000046c0| 20 61 72 65 20 67 69 76 | 65 6e 2c 20 74 68 65 79 | are giv|en, they|
|000046d0| 20 77 69 6c 6c 20 64 65 | 66 69 6e 65 20 61 20 70 | will de|fine a p|
|000046e0| 72 6f 63 65 73 73 20 76 | 69 61 20 0d 74 68 65 20 |rocess v|ia .the |
|000046f0| 50 50 43 50 6f 72 74 52 | 65 63 20 61 6e 64 20 4c |PPCPortR|ec and L|
|00004700| 6f 63 61 74 69 6f 6e 4e | 61 6d 65 52 65 63 20 73 |ocationN|ameRec s|
|00004710| 74 72 75 63 74 75 72 65 | 73 2e 20 54 68 65 20 70 |tructure|s. The p|
|00004720| 6f 72 74 5f 6e 61 6d 65 | 20 70 61 72 61 6d 61 74 |ort_name| paramat|
|00004730| 65 72 20 0d 73 68 6f 75 | 6c 64 20 62 65 20 69 6e |er .shou|ld be in|
|00004740| 20 74 68 65 20 66 6f 72 | 6d 20 22 6e 61 6d 65 2c | the for|m "name,|
|00004750| 74 79 70 65 22 20 61 6e | 64 20 6c 6f 63 61 74 69 |type" an|d locati|
|00004760| 6f 6e 5f 6e 61 6d 65 20 | 73 68 6f 75 6c 64 20 62 |on_name |should b|
|00004770| 65 20 69 6e 20 74 68 65 | 20 66 6f 72 6d 20 0d 6f |e in the| form .o|
|00004780| 62 6a 65 63 74 3a 74 79 | 70 65 40 7a 6f 6e 65 2e |bject:ty|pe@zone.|
|00004790| 20 46 6f 72 20 69 6e 73 | 74 61 6e 63 65 2c 20 22 | For ins|tance, "|
|000047a0| 74 63 6c 45 6e 67 69 6e | 65 2c 74 63 6c 20 65 6e |tclEngin|e,tcl en|
|000047b0| 67 69 6e 65 22 20 22 4a | 6f 65 27 73 20 0d 4d 61 |gine" "J|oe's .Ma|
|000047c0| 63 69 6e 74 6f 73 68 3a | 50 50 43 54 6f 6f 6c 62 |cintosh:|PPCToolb|
|000047d0| 6f 78 40 6d 79 7a 6f 6e | 65 22 2e 0d 49 66 20 6e |ox@myzon|e"..If n|
|000047e0| 6f 20 70 61 72 61 6d 65 | 74 65 72 73 20 61 72 65 |o parame|ters are|
|000047f0| 20 70 72 65 73 65 6e 74 | 2c 20 74 68 65 20 63 6f | present|, the co|
|00004800| 6d 6d 61 6e 64 20 77 69 | 6c 6c 20 64 69 73 70 6c |mmand wi|ll displ|
|00004810| 61 79 20 74 68 65 20 50 | 50 43 42 72 6f 77 73 65 |ay the P|PCBrowse|
|00004820| 72 20 64 69 61 6c 6f 67 | 20 0d 61 6c 6c 6f 77 69 |r dialog| .allowi|
|00004830| 6e 67 20 79 6f 75 20 74 | 6f 20 73 65 6c 65 63 74 |ng you t|o select|
|00004840| 20 61 20 70 72 6f 63 65 | 73 73 2e 20 4f 6e 63 65 | a proce|ss. Once|
|00004850| 20 74 68 69 73 20 63 6f | 6d 6d 61 6e 64 20 69 73 | this co|mmand is|
|00004860| 20 73 75 63 63 65 73 73 | 66 75 6c 6c 79 20 65 78 | success|fully ex|
|00004870| 65 63 75 74 65 64 2c 20 | 74 68 65 20 0d 6e 61 6d |ecuted, |the .nam|
|00004880| 65 20 6d 61 79 20 62 65 | 20 75 73 65 64 20 69 6e |e may be| used in|
|00004890| 20 61 6e 79 20 6f 66 20 | 74 68 65 20 41 70 70 6c | any of |the Appl|
|000048a0| 65 20 45 76 65 6e 74 20 | 63 6f 6d 6d 61 6e 64 73 |e Event |commands|
|000048b0| 20 6c 69 73 74 65 64 20 | 62 65 6c 6f 77 20 74 6f | listed |below to|
|000048c0| 20 69 64 65 6e 74 69 66 | 79 20 74 68 65 20 0d 74 | identif|y the .t|
|000048d0| 61 72 67 72 65 74 20 6f | 66 20 74 68 65 20 41 70 |argret o|f the Ap|
|000048e0| 70 6c 65 20 45 76 65 6e | 74 2e 20 54 68 65 72 65 |ple Even|t. There|
|000048f0| 20 61 72 65 20 61 20 6d | 61 78 69 6d 75 6d 20 6f | are a m|aximum o|
|00004900| 66 20 65 69 67 68 74 20 | 28 38 29 20 74 61 72 67 |f eight |(8) targ|
|00004910| 65 74 73 20 74 68 61 74 | 20 6d 61 79 20 62 65 20 |ets that| may be |
|00004920| 0d 6f 70 65 6e 20 73 69 | 6d 75 6c 74 61 6e 65 6f |.open si|multaneo|
|00004930| 75 73 6c 79 2e 0d 0d 0d | 61 65 63 6c 6f 73 65 20 |usly....|aeclose |
|00004940| 6e 61 6d 65 0d 0d 54 68 | 69 73 20 63 6f 6d 6d 61 |name..Th|is comma|
|00004950| 6e 64 20 77 69 6c 6c 20 | 63 6c 6f 73 65 20 74 68 |nd will |close th|
|00004960| 65 20 6e 61 6d 65 64 20 | 41 70 70 6c 65 20 45 76 |e named |Apple Ev|
|00004970| 65 6e 74 20 74 61 72 67 | 65 74 20 6f 70 65 6e 65 |ent targ|et opene|
|00004980| 64 20 62 79 20 61 65 6f | 70 65 6e 2e 0d 0d 0d 61 |d by aeo|pen....a|
|00004990| 65 73 65 6e 64 20 6e 61 | 6d 65 20 5b 2d 74 20 74 |esend na|me [-t t|
|000049a0| 69 63 6b 73 5d 20 5b 2d | 77 5d 20 5b 2d 69 5d 20 |icks] [-|w] [-i] |
|000049b0| 5b 2d 6f 5d 20 5b 2d 6c | 5d 20 5b 2d 78 5d 0d 09 |[-o] [-l|] [-x]..|
|000049c0| 09 63 6c 61 73 73 20 65 | 76 65 6e 74 20 64 61 74 |.class e|vent dat|
|000049d0| 61 0d 0d 54 68 69 73 20 | 63 6f 6d 6d 61 6e 64 20 |a..This |command |
|000049e0| 69 73 20 75 73 65 64 20 | 74 6f 20 73 65 6e 64 20 |is used |to send |
|000049f0| 61 6e 20 41 70 70 6c 65 | 20 45 76 65 6e 74 20 74 |an Apple| Event t|
|00004a00| 6f 20 74 68 65 20 6e 61 | 6d 65 64 20 74 61 72 67 |o the na|med targ|
|00004a10| 65 74 2c 20 6e 61 6d 65 | 2c 20 0d 70 72 65 76 69 |et, name|, .previ|
|00004a20| 6f 75 73 6c 79 20 6f 70 | 65 6e 65 64 20 62 79 20 |ously op|ened by |
|00004a30| 61 65 6f 70 65 6e 2e 20 | 43 6c 61 73 73 20 61 6e |aeopen. |Class an|
|00004a40| 64 20 65 76 65 6e 74 20 | 61 72 65 20 74 68 65 20 |d event |are the |
|00004a50| 63 6f 72 72 65 73 70 6f | 6e 64 69 6e 67 20 66 6f |correspo|nding fo|
|00004a60| 75 72 20 63 68 61 72 61 | 63 74 65 72 20 0d 74 79 |ur chara|cter .ty|
|00004a70| 70 65 73 20 74 68 61 74 | 20 64 65 74 65 72 6d 69 |pes that| determi|
|00004a80| 6e 65 20 74 68 65 20 63 | 6c 61 73 73 20 61 6e 64 |ne the c|lass and|
|00004a90| 20 65 76 65 6e 74 20 69 | 64 20 6f 66 20 74 68 65 | event i|d of the|
|00004aa0| 20 41 70 70 6c 65 20 45 | 76 65 6e 74 2e 20 54 68 | Apple E|vent. Th|
|00004ab0| 65 20 64 61 74 61 20 66 | 69 65 6c 64 20 0d 63 6f |e data f|ield .co|
|00004ac0| 6e 74 61 69 6e 73 20 74 | 68 65 20 64 65 73 69 72 |ntains t|he desir|
|00004ad0| 65 64 20 63 6f 6e 74 65 | 6e 74 73 20 6f 66 20 74 |ed conte|nts of t|
|00004ae0| 68 65 20 41 70 70 6c 65 | 20 45 76 65 6e 74 2e 0d |he Apple| Event..|
|00004af0| 54 68 65 20 2d 74 20 6f | 70 74 69 6f 6e 20 61 6c |The -t o|ption al|
|00004b00| 6c 6f 77 73 20 74 68 65 | 20 73 70 65 63 69 66 69 |lows the| specifi|
|00004b10| 63 61 74 69 6f 6e 20 6f | 66 20 74 68 65 20 73 65 |cation o|f the se|
|00004b20| 6e 64 20 74 69 6d 65 6f | 75 74 20 69 6e 20 74 69 |nd timeo|ut in ti|
|00004b30| 63 6b 73 2e 20 54 68 65 | 20 64 65 66 61 75 6c 74 |cks. The| default|
|00004b40| 20 69 73 20 31 32 30 20 | 0d 6f 72 20 32 20 73 65 | is 120 |.or 2 se|
|00004b50| 63 6f 6e 64 73 2e 20 54 | 68 65 20 2d 77 20 6f 70 |conds. T|he -w op|
|00004b60| 74 69 6f 6e 20 75 73 65 | 73 20 74 68 65 20 6b 41 |tion use|s the kA|
|00004b70| 45 57 61 69 74 52 65 70 | 6c 79 20 6f 70 74 69 6f |EWaitRep|ly optio|
|00004b80| 6e 2c 20 77 68 65 72 65 | 20 6b 41 45 4e 6f 52 65 |n, where| kAENoRe|
|00004b90| 70 6c 79 20 69 73 20 0d | 74 68 65 20 64 65 66 61 |ply is .|the defa|
|00004ba0| 75 6c 74 2e 20 54 68 65 | 20 2d 69 20 6f 70 74 69 |ult. The| -i opti|
|00004bb0| 6f 6e 20 75 73 65 73 20 | 74 68 65 20 6b 43 61 6e |on uses |the kCan|
|00004bc0| 49 6e 74 65 72 61 63 74 | 20 6f 70 74 69 6f 6e 2c |Interact| option,|
|00004bd0| 20 77 68 65 72 65 20 6b | 41 45 4e 65 76 65 72 49 | where k|AENeverI|
|00004be0| 6e 74 65 72 61 63 74 20 | 69 73 20 0d 74 68 65 20 |nteract |is .the |
|00004bf0| 64 65 66 61 75 6c 74 2e | 20 54 68 65 20 2d 6f 20 |default.| The -o |
|00004c00| 6f 70 74 69 6f 6e 20 61 | 6c 6c 6f 77 73 20 79 6f |option a|llows yo|
|00004c10| 75 20 74 6f 20 73 65 6c | 65 63 74 20 74 68 65 20 |u to sel|ect the |
|00004c20| 73 74 61 6e 64 61 72 64 | 20 6f 75 74 70 75 74 20 |standard| output |
|00004c30| 6f 66 20 74 68 65 20 72 | 65 70 6c 79 20 64 61 74 |of the r|eply dat|
|00004c40| 61 2e 20 0d 54 68 69 73 | 20 69 73 20 6f 6e 6c 79 |a. .This| is only|
|00004c50| 20 75 73 65 66 75 6c 20 | 77 68 65 6e 20 74 61 6c | useful |when tal|
|00004c60| 6b 69 6e 67 20 77 69 74 | 68 20 61 6e 6f 74 68 65 |king wit|h anothe|
|00004c70| 72 20 74 69 63 6b 6c 65 | 2c 20 73 69 6e 63 65 20 |r tickle|, since |
|00004c80| 74 68 65 20 73 74 61 6e | 64 61 72 64 20 6f 75 74 |the stan|dard out|
|00004c90| 70 75 74 20 0d 70 61 72 | 61 6d 61 74 65 72 20 74 |put .par|amater t|
|00004ca0| 79 70 65 20 69 73 20 6f | 6e 6c 79 20 64 65 66 69 |ype is o|nly defi|
|00004cb0| 6e 65 64 20 62 79 20 74 | 69 63 6b 6c 65 2e 20 54 |ned by t|ickle. T|
|00004cc0| 68 65 20 2d 6c 20 6f 70 | 74 69 6f 6e 20 73 70 65 |he -l op|tion spe|
|00004cd0| 63 69 66 69 65 73 20 74 | 68 61 74 20 79 6f 75 20 |cifies t|hat you |
|00004ce0| 77 61 6e 74 20 74 68 65 | 20 0d 6f 75 74 70 75 74 |want the| .output|
|00004cf0| 20 69 6e 20 6c 6f 6e 67 | 20 66 6f 72 6d 61 74 2c | in long| format,|
|00004d00| 20 77 69 74 68 20 74 68 | 65 20 72 65 74 75 72 6e | with th|e return|
|00004d10| 65 64 20 64 61 74 61 20 | 74 79 70 65 20 28 34 20 |ed data |type (4 |
|00004d20| 63 68 61 72 61 63 74 65 | 72 73 29 20 66 69 72 73 |characte|rs) firs|
|00004d30| 74 2c 20 74 68 65 6e 20 | 74 68 65 20 64 61 74 61 |t, then |the data|
|00004d40| 2e 20 0d 54 68 65 20 2d | 78 20 6f 70 74 69 6f 6e |. .The -|x option|
|00004d50| 20 69 73 20 75 73 65 64 | 20 74 6f 20 67 65 74 20 | is used| to get |
|00004d60| 74 68 65 20 6f 75 74 70 | 75 74 20 61 73 20 68 65 |the outp|ut as he|
|00004d70| 78 20 64 61 74 61 20 69 | 6e 73 74 65 61 64 20 6f |x data i|nstead o|
|00004d80| 66 20 74 65 78 74 20 64 | 61 74 61 2e 20 52 65 67 |f text d|ata. Reg|
|00004d90| 61 72 64 6c 65 73 73 20 | 0d 6f 66 20 74 68 65 20 |ardless |.of the |
|00004da0| 64 61 74 61 20 6f 75 74 | 70 75 74 20 66 6f 72 6d |data out|put form|
|00004db0| 61 74 20 6f 72 20 6f 70 | 74 69 6f 6e 73 2c 20 74 |at or op|tions, t|
|00004dc0| 68 65 20 6f 75 74 70 75 | 74 20 77 69 6c 6c 20 61 |he outpu|t will a|
|00004dd0| 6c 77 61 79 73 20 62 65 | 20 62 72 61 63 6b 65 74 |lways be| bracket|
|00004de0| 65 64 20 62 79 20 63 75 | 72 6c 79 20 0d 62 72 61 |ed by cu|rly .bra|
|00004df0| 63 65 73 20 74 6f 20 61 | 76 6f 69 64 20 70 72 6f |ces to a|void pro|
|00004e00| 62 6c 65 6d 73 20 77 69 | 74 68 20 73 70 61 63 65 |blems wi|th space|
|00004e10| 73 20 69 6e 20 74 68 65 | 20 6f 75 74 70 75 74 2e |s in the| output.|
|00004e20| 0d 54 68 65 20 64 61 74 | 61 20 66 69 65 6c 64 20 |.The dat|a field |
|00004e30| 63 6f 6e 73 69 73 74 73 | 20 6f 66 20 70 61 69 72 |consists| of pair|
|00004e40| 73 20 6f 66 20 70 61 72 | 61 6d 65 74 65 72 73 2c |s of par|ameters,|
|00004e50| 20 74 68 65 20 66 69 72 | 73 74 20 62 65 69 6e 67 | the fir|st being|
|00004e60| 20 61 20 66 6c 61 67 20 | 61 6e 64 20 74 68 65 20 | a flag |and the |
|00004e70| 73 65 63 6f 6e 64 20 0d | 64 61 74 61 2e 20 54 68 |second .|data. Th|
|00004e80| 65 20 66 6c 61 67 20 65 | 69 74 68 65 72 20 62 65 |e flag e|ither be|
|00004e90| 67 69 6e 73 20 77 69 74 | 68 20 27 2b 27 20 6f 72 |gins wit|h '+' or|
|00004ea0| 20 27 2d 27 2e 20 41 20 | 27 2d 27 20 69 6e 64 69 | '-'. A |'-' indi|
|00004eb0| 63 61 74 65 73 20 74 68 | 61 74 20 74 68 65 20 74 |cates th|at the t|
|00004ec0| 77 6f 20 66 6f 6c 6c 6f | 77 69 6e 67 20 0d 71 75 |wo follo|wing .qu|
|00004ed0| 61 72 74 65 74 73 20 6f | 66 20 63 68 61 72 61 63 |artets o|f charac|
|00004ee0| 74 65 72 73 20 61 72 65 | 20 74 68 65 20 64 61 74 |ters are| the dat|
|00004ef0| 61 20 6b 65 79 20 61 6e | 64 20 74 79 70 65 20 6f |a key an|d type o|
|00004f00| 66 20 74 68 65 20 64 61 | 74 61 20 74 68 61 74 20 |f the da|ta that |
|00004f10| 66 6f 6c 6c 6f 77 73 2e | 20 46 6f 72 20 0d 65 78 |follows.| For .ex|
|00004f20| 61 6d 70 6c 65 3a 0d 09 | 2d 2d 2d 2d 2d 54 45 58 |ample:..|-----TEX|
|00004f30| 54 20 22 54 68 69 73 20 | 69 73 20 61 20 73 74 72 |T "This |is a str|
|00004f40| 69 6e 67 2e 22 0d 77 6f | 75 6c 64 20 63 72 65 61 |ing.".wo|uld crea|
|00004f50| 74 65 20 61 6e 20 41 70 | 70 6c 65 20 45 76 65 6e |te an Ap|ple Even|
|00004f60| 74 20 74 68 61 74 20 63 | 6f 6e 74 61 69 6e 65 64 |t that c|ontained|
|00004f70| 20 61 20 44 69 72 65 63 | 74 20 50 61 72 61 6d 65 | a Direc|t Parame|
|00004f80| 74 65 72 20 28 2d 2d 2d | 2d 29 20 6f 66 20 74 79 |ter (---|-) of ty|
|00004f90| 70 65 20 0d 27 54 45 58 | 54 27 2e 20 54 68 69 73 |pe .'TEX|T'. This|
|00004fa0| 20 69 73 20 61 20 70 65 | 72 66 65 63 74 6c 79 20 | is a pe|rfectly |
|00004fb0| 67 6f 6f 64 20 74 79 70 | 65 20 66 6f 72 20 73 65 |good typ|e for se|
|00004fc0| 6e 64 69 6e 67 20 73 63 | 72 69 70 74 73 2c 20 61 |nding sc|ripts, a|
|00004fd0| 73 20 69 6e 3a 0d 09 61 | 65 73 65 6e 64 20 4e 41 |s in:..a|esend NA|
|00004fe0| 4d 45 20 6d 69 73 63 20 | 64 6f 73 63 20 2d 2d 2d |ME misc |dosc ---|
|00004ff0| 2d 2d 54 45 58 54 20 7b | 70 72 69 6e 74 20 22 48 |--TEXT {|print "H|
|00005000| 65 6c 6c 6f 20 57 6f 72 | 6c 64 21 22 7d 0d 0d 54 |ello Wor|ld!"}..T|
|00005010| 68 65 20 6f 74 68 65 72 | 20 66 6f 72 6d 20 6f 66 |he other| form of|
|00005020| 20 64 61 74 61 20 73 70 | 65 63 69 66 69 63 61 74 | data sp|ecificat|
|00005030| 69 6f 6e 20 69 73 20 74 | 68 65 20 27 2b 27 20 66 |ion is t|he '+' f|
|00005040| 6f 72 6d 2e 20 54 68 69 | 73 20 66 6f 72 6d 20 75 |orm. Thi|s form u|
|00005050| 73 65 73 20 74 68 65 20 | 41 45 42 75 69 6c 64 20 |ses the |AEBuild |
|00005060| 0d 74 6f 6f 6c 20 66 72 | 6f 6d 20 41 70 70 6c 65 |.tool fr|om Apple|
|00005070| 2e 20 54 68 69 73 20 69 | 73 20 64 65 73 63 72 69 |. This i|s descri|
|00005080| 62 65 64 20 69 6e 20 74 | 68 65 20 41 45 42 75 69 |bed in t|he AEBui|
|00005090| 6c 64 20 64 6f 63 75 6d | 65 6e 74 2e 20 42 72 69 |ld docum|ent. Bri|
|000050a0| 65 66 6c 79 2c 20 41 45 | 42 75 69 6c 64 20 69 73 |efly, AE|Build is|
|000050b0| 20 61 20 0d 74 6f 6f 6c | 20 74 68 61 74 20 61 6c | a .tool| that al|
|000050c0| 6c 6f 77 73 20 79 6f 75 | 20 74 6f 20 67 69 76 65 |lows you| to give|
|000050d0| 20 61 20 64 65 74 61 69 | 6c 65 64 20 41 70 70 6c | a detai|led Appl|
|000050e0| 65 20 45 76 65 6e 74 20 | 64 65 73 63 72 69 70 74 |e Event |descript|
|000050f0| 69 6f 6e 20 77 69 74 68 | 20 61 20 66 6c 65 78 69 |ion with| a flexi|
|00005100| 62 6c 65 20 0d 73 79 6e | 74 61 78 2e 20 54 68 75 |ble .syn|tax. Thu|
|00005110| 73 2c 20 74 68 65 20 61 | 62 6f 76 65 20 65 78 61 |s, the a|bove exa|
|00005120| 6d 70 6c 65 20 6d 69 67 | 68 74 20 62 65 20 77 72 |mple mig|ht be wr|
|00005130| 69 74 74 65 6e 20 61 73 | 3a 0d 09 61 65 73 65 6e |itten as|:..aesen|
|00005140| 64 20 4e 41 4d 45 20 6d | 69 73 63 20 64 6f 73 63 |d NAME m|isc dosc|
|00005150| 20 2b 2d 2d 2d 2d 20 7b | d2 70 72 69 6e 74 20 22 | +---- {|.print "|
|00005160| 48 65 6c 6c 6f 20 57 6f | 72 6c 64 21 22 d3 7d 0d |Hello Wo|rld!".}.|
|00005170| 0d 54 68 65 20 41 45 42 | 75 69 6c 64 20 73 79 6e |.The AEB|uild syn|
|00005180| 74 61 78 20 61 6c 6c 6f | 77 73 20 66 6f 72 20 6d |tax allo|ws for m|
|00005190| 6f 72 65 20 63 6f 6d 70 | 6c 65 78 20 64 65 73 63 |ore comp|lex desc|
|000051a0| 72 69 70 74 69 6f 6e 73 | 2c 20 6d 6f 73 74 20 69 |riptions|, most i|
|000051b0| 6d 70 6f 72 74 61 6e 74 | 6c 79 20 6c 69 73 74 73 |mportant|ly lists|
|000051c0| 2c 20 0d 77 68 69 63 68 | 20 61 72 65 20 72 65 71 |, .which| are req|
|000051d0| 75 69 72 65 64 20 66 6f | 72 20 73 69 6d 70 6c 65 |uired fo|r simple|
|000051e0| 20 74 68 69 6e 67 73 20 | 6c 69 6b 65 20 27 61 65 | things |like 'ae|
|000051f0| 76 74 27 20 27 6f 64 6f | 63 27 2e 0d 41 45 42 75 |vt' 'odo|c'..AEBu|
|00005200| 69 6c 64 20 68 61 73 20 | 6f 6e 65 20 6d 61 6a 6f |ild has |one majo|
|00005210| 72 20 73 68 6f 72 74 63 | 6f 6d 69 6e 67 2e 20 57 |r shortc|oming. W|
|00005220| 68 65 6e 20 69 74 20 70 | 65 72 66 6f 72 6d 73 20 |hen it p|erforms |
|00005230| 63 6f 65 72 63 69 6f 6e | 2c 20 69 74 20 6f 6e 6c |coercion|, it onl|
|00005240| 79 20 63 61 6c 6c 73 20 | 74 68 65 20 0d 63 6f 65 |y calls |the .coe|
|00005250| 72 63 69 6f 6e 20 68 61 | 6e 64 6c 65 72 20 69 66 |rcion ha|ndler if|
|00005260| 20 74 68 65 20 63 6f 65 | 72 63 69 6f 6e 20 69 73 | the coe|rcion is|
|00005270| 20 6e 75 6d 65 72 69 63 | 2e 20 46 6f 72 20 61 6c | numeric|. For al|
|00005280| 6c 20 6f 74 68 65 72 20 | 63 6f 65 72 63 69 6f 6e |l other |coercion|
|00005290| 73 2c 20 41 45 42 75 69 | 6c 64 20 73 69 6d 70 6c |s, AEBui|ld simpl|
|000052a0| 79 20 0d 6d 6f 64 69 66 | 69 65 73 20 74 68 65 20 |y .modif|ies the |
|000052b0| 64 65 73 63 72 69 70 74 | 6f 72 54 79 70 65 20 66 |descript|orType f|
|000052c0| 69 65 6c 64 20 6f 66 20 | 74 68 65 20 41 45 44 65 |ield of |the AEDe|
|000052d0| 73 63 20 73 74 72 75 63 | 74 75 72 65 2e 20 42 65 |sc struc|ture. Be|
|000052e0| 63 61 75 73 65 20 6f 66 | 20 74 68 69 73 2c 20 79 |cause of| this, y|
|000052f0| 6f 75 20 77 69 6c 6c 20 | 0d 68 61 76 65 20 74 6f |ou will |.have to|
|00005300| 20 75 73 65 20 74 68 65 | 20 61 62 69 6c 69 74 79 | use the| ability|
|00005310| 20 74 6f 20 69 6e 73 74 | 61 6c 6c 20 63 6f 65 72 | to inst|all coer|
|00005320| 63 69 6f 6e 20 68 61 6e | 64 6c 65 72 73 20 74 6f |cion han|dlers to|
|00005330| 20 70 72 6f 64 75 63 65 | 20 48 45 58 20 64 61 74 | produce| HEX dat|
|00005340| 61 2c 20 77 68 69 63 68 | 20 79 6f 75 20 0d 63 61 |a, which| you .ca|
|00005350| 6e 20 70 6c 61 63 65 20 | 69 6e 20 74 68 65 20 41 |n place |in the A|
|00005360| 45 42 75 69 6c 64 20 73 | 70 65 63 69 66 69 63 61 |EBuild s|pecifica|
|00005370| 74 69 6f 6e 20 77 69 74 | 68 20 74 68 65 20 61 65 |tion wit|h the ae|
|00005380| 63 6f 65 72 63 65 20 63 | 6f 6d 6d 61 6e 64 2e 20 |coerce c|ommand. |
|00005390| 53 69 6e 63 65 20 74 68 | 65 20 48 45 58 20 0d 64 |Since th|e HEX .d|
|000053a0| 61 74 61 20 69 73 20 6e | 61 74 69 76 65 2c 20 20 |ata is n|ative,  |
|000053b0| 74 68 65 20 6f 6e 6c 79 | 20 63 6f 65 72 63 69 6f |the only| coercio|
|000053c0| 6e 20 72 65 71 75 69 72 | 65 6d 65 6e 74 20 69 73 |n requir|ement is|
|000053d0| 20 74 68 65 20 73 65 74 | 74 69 6e 67 20 6f 66 20 | the set|ting of |
|000053e0| 74 68 65 20 64 65 73 63 | 72 69 70 74 6f 72 54 79 |the desc|riptorTy|
|000053f0| 70 65 20 0d 66 69 65 6c | 64 2e 0d 49 66 20 79 6f |pe .fiel|d..If yo|
|00005400| 75 20 66 6f 6c 6c 6f 77 | 65 64 20 74 68 65 20 61 |u follow|ed the a|
|00005410| 62 6f 76 65 20 64 69 73 | 63 75 73 73 69 6f 6e 2c |bove dis|cussion,|
|00005420| 20 74 68 65 6e 20 79 6f | 75 20 77 69 6c 6c 20 72 | then yo|u will r|
|00005430| 65 63 6f 67 6e 69 7a 65 | 20 74 68 65 20 66 6f 6c |ecognize| the fol|
|00005440| 6c 6f 77 69 6e 67 20 0d | 63 6f 6d 6d 61 6e 64 20 |lowing .|command |
|00005450| 61 73 20 61 20 73 69 6d | 70 6c 65 20 72 65 71 75 |as a sim|ple requ|
|00005460| 65 73 74 20 74 6f 20 6f | 70 65 6e 20 61 20 64 6f |est to o|pen a do|
|00005470| 63 75 6d 65 6e 74 2e 20 | 59 6f 75 20 77 69 6c 6c |cument. |You will|
|00005480| 20 61 6c 73 6f 20 6e 6f | 74 65 20 74 68 61 74 20 | also no|te that |
|00005490| 69 74 20 0d 64 65 70 65 | 6e 64 73 20 75 70 6f 6e |it .depe|nds upon|
|000054a0| 20 61 6e 20 65 78 74 65 | 72 6e 61 6c 20 63 6f 65 | an exte|rnal coe|
|000054b0| 72 63 69 6f 6e 20 68 61 | 6e 64 6c 65 72 20 6e 61 |rcion ha|ndler na|
|000054c0| 6d 65 64 20 50 52 4f 43 | 5f 54 45 58 54 61 6c 69 |med PROC|_TEXTali|
|000054d0| 73 2c 20 77 68 69 63 68 | 20 0d 63 6f 6e 76 65 72 |s, which| .conver|
|000054e0| 74 73 20 61 20 66 75 6c | 6c 20 70 61 74 68 20 6e |ts a ful|l path n|
|000054f0| 61 6d 65 20 69 6e 74 6f | 20 61 6e 20 61 6c 69 61 |ame into| an alia|
|00005500| 73 2e 0d 09 61 65 73 65 | 6e 64 20 54 4f 4f 4c 20 |s...aese|nd TOOL |
|00005510| 61 65 76 74 20 6f 64 6f | 63 20 2b 2d 2d 2d 2d 20 |aevt odo|c +---- |
|00005520| 5b 20 63 6f 6e 63 61 74 | 0d 09 09 7b 5b 20 61 6c |[ concat|...{[ al|
|00005530| 69 73 28 c7 7d 20 5b 20 | 61 65 63 6f 65 72 63 65 |is(.} [ |aecoerce|
|00005540| 20 54 45 58 54 20 22 51 | 75 69 6c 6c 2e 74 78 74 | TEXT "Q|uill.txt|
|00005550| 22 20 2d 78 20 61 6c 69 | 73 20 5d 20 7b c8 29 20 |" -x ali|s ] {.) |
|00005560| 5d 7d 0d 09 09 5d 0d 0d | 0d 61 65 6c 6f 61 64 20 |]}...]..|.aeload |
|00005570| 66 69 6c 65 6e 61 6d 65 | 0d 0d 54 68 69 73 20 63 |filename|..This c|
|00005580| 6f 6d 6d 61 6e 64 20 77 | 69 6c 6c 20 6c 6f 61 64 |ommand w|ill load|
|00005590| 20 61 6c 6c 20 63 6f 65 | 72 63 69 6f 6e 20 61 6e | all coe|rcion an|
|000055a0| 64 20 41 70 70 6c 65 20 | 45 76 65 6e 74 20 68 61 |d Apple |Event ha|
|000055b0| 6e 64 6c 65 72 73 20 63 | 6f 6e 74 61 69 6e 65 64 |ndlers c|ontained|
|000055c0| 20 69 6e 20 0d 66 69 6c | 65 6e 61 6d 65 2e 0d 0d | in .fil|ename...|
|000055d0| 0d 61 65 63 6f 65 72 63 | 65 20 66 72 6f 6d 54 79 |.aecoerc|e fromTy|
|000055e0| 70 65 20 5b 2d 78 5d 20 | 64 61 74 61 20 5b 2d 78 |pe [-x] |data [-x|
|000055f0| 5d 20 74 6f 54 79 70 65 | 0d 0d 54 68 69 73 20 63 |] toType|..This c|
|00005600| 6f 6d 6d 61 6e 64 20 77 | 69 6c 6c 20 63 61 6c 6c |ommand w|ill call|
|00005610| 20 74 68 65 20 61 70 70 | 72 6f 70 72 69 61 74 65 | the app|ropriate|
|00005620| 20 63 6f 65 72 63 69 6f | 6e 20 68 61 6e 64 6c 65 | coercio|n handle|
|00005630| 72 20 74 6f 20 63 6f 65 | 72 63 65 20 64 61 74 61 |r to coe|rce data|
|00005640| 20 66 72 6f 6d 20 0d 66 | 72 6f 6d 54 79 70 65 20 | from .f|romType |
|00005650| 69 6e 74 6f 20 74 6f 54 | 79 70 65 2e 0d 54 68 65 |into toT|ype..The|
|00005660| 20 64 61 74 61 20 69 73 | 20 63 6f 6e 73 69 64 65 | data is| conside|
|00005670| 72 65 64 20 74 6f 20 62 | 65 20 74 65 78 74 2c 20 |red to b|e text, |
|00005680| 75 6e 6c 65 73 73 20 74 | 68 65 20 6f 70 74 69 6f |unless t|he optio|
|00005690| 6e 61 6c 20 2d 78 20 69 | 73 20 70 72 65 73 65 6e |nal -x i|s presen|
|000056a0| 74 20 69 6d 6d 65 64 69 | 61 74 65 6c 79 20 0d 62 |t immedi|ately .b|
|000056b0| 65 66 6f 72 65 20 74 68 | 65 20 64 61 74 61 20 70 |efore th|e data p|
|000056c0| 61 72 61 6d 65 74 65 72 | 2c 20 69 6e 20 77 68 69 |arameter|, in whi|
|000056d0| 63 68 20 63 61 73 65 20 | 69 74 20 69 73 20 63 6f |ch case |it is co|
|000056e0| 6e 73 69 64 65 72 65 64 | 20 74 6f 20 62 65 20 68 |nsidered| to be h|
|000056f0| 65 78 20 64 61 74 61 2e | 20 54 68 65 20 64 61 74 |ex data.| The dat|
|00005700| 61 20 0d 77 69 6c 6c 20 | 62 65 20 72 65 61 64 20 |a .will |be read |
|00005710| 69 6e 74 6f 20 74 68 65 | 20 64 61 74 61 48 61 6e |into the| dataHan|
|00005720| 64 6c 65 20 6f 66 20 61 | 6e 20 41 45 44 65 73 63 |dle of a|n AEDesc|
|00005730| 20 73 74 72 75 63 74 75 | 72 65 2c 20 74 68 65 6e | structu|re, then|
|00005740| 20 74 68 65 20 64 65 73 | 63 72 69 70 74 6f 72 54 | the des|criptorT|
|00005750| 79 70 65 20 0d 66 69 65 | 6c 64 20 73 65 74 20 74 |ype .fie|ld set t|
|00005760| 6f 20 66 72 6f 6d 54 79 | 70 65 2c 20 61 6e 64 20 |o fromTy|pe, and |
|00005770| 74 68 65 20 41 45 44 65 | 73 63 20 73 74 72 75 63 |the AEDe|sc struc|
|00005780| 74 75 72 65 20 70 61 73 | 73 65 64 20 74 6f 20 41 |ture pas|sed to A|
|00005790| 45 43 6f 65 72 63 65 44 | 65 73 63 28 29 20 74 6f |ECoerceD|esc() to|
|000057a0| 20 62 65 20 0d 63 6f 65 | 72 63 65 64 20 69 6e 74 | be .coe|rced int|
|000057b0| 6f 20 74 6f 54 79 70 65 | 2e 0d 54 68 65 20 72 65 |o toType|..The re|
|000057c0| 73 75 6c 74 69 6e 67 20 | 64 61 74 61 20 77 69 6c |sulting |data wil|
|000057d0| 6c 20 62 65 20 72 65 74 | 75 72 6e 65 64 20 61 73 |l be ret|urned as|
|000057e0| 20 74 65 78 74 20 64 61 | 74 61 20 28 77 68 69 63 | text da|ta (whic|
|000057f0| 68 20 69 73 20 70 72 6f | 62 6c 65 6d 61 74 69 63 |h is pro|blematic|
|00005800| 20 69 66 20 69 74 20 63 | 6f 6e 74 61 69 6e 73 20 | if it c|ontains |
|00005810| 0d 7a 65 72 6f 73 20 69 | 6e 20 74 68 65 20 64 61 |.zeros i|n the da|
|00005820| 74 61 29 2c 20 75 6e 6c | 65 73 73 20 74 68 65 20 |ta), unl|ess the |
|00005830| 6f 70 74 69 6f 6e 61 6c | 20 2d 78 20 69 73 20 70 |optional| -x is p|
|00005840| 72 65 73 65 6e 74 20 69 | 6d 6d 65 64 69 61 74 65 |resent i|mmediate|
|00005850| 6c 79 20 62 65 66 6f 72 | 65 20 74 68 65 74 6f 54 |ly befor|e thetoT|
|00005860| 79 70 65 20 0d 70 61 72 | 61 6d 65 74 65 72 2c 20 |ype .par|ameter, |
|00005870| 69 6e 20 77 68 69 63 68 | 20 63 61 73 65 20 74 68 |in which| case th|
|00005880| 65 20 64 61 74 61 20 77 | 69 6c 6c 20 62 65 20 72 |e data w|ill be r|
|00005890| 65 74 75 72 6e 65 64 20 | 61 73 20 68 65 78 20 64 |eturned |as hex d|
|000058a0| 61 74 61 2e 0d 0d 0d 61 | 65 6c 69 73 74 0d 0d 54 |ata....a|elist..T|
|000058b0| 68 69 73 20 63 6f 6d 6d | 61 6e 64 20 77 69 6c 6c |his comm|and will|
|000058c0| 20 6c 69 73 74 20 61 6c | 6c 20 6f 70 65 6e 20 74 | list al|l open t|
|000058d0| 61 72 67 65 74 73 20 74 | 68 61 74 20 77 65 72 65 |argets t|hat were|
|000058e0| 20 6f 62 74 61 69 6e 65 | 64 20 76 69 61 20 61 65 | obtaine|d via ae|
|000058f0| 6f 70 65 6e 2e 0d 0d 0d | 61 65 74 61 72 67 65 74 |open....|aetarget|
|00005900| 73 20 6f 62 6a 65 63 74 | 20 74 79 70 65 20 7a 6f |s object| type zo|
|00005910| 6e 65 0d 0d 54 68 69 73 | 20 63 6f 6d 6d 61 6e 64 |ne..This| command|
|00005920| 20 77 69 6c 6c 20 6c 69 | 73 74 20 61 6c 6c 20 61 | will li|st all a|
|00005930| 76 61 69 6c 61 62 6c 65 | 20 74 61 72 67 65 74 73 |vailable| targets|
|00005940| 20 61 63 63 6f 72 64 69 | 6e 67 20 74 6f 20 74 68 | accordi|ng to th|
|00005950| 65 20 73 70 65 63 69 66 | 69 65 64 20 70 61 72 61 |e specif|ied para|
|00005960| 6d 65 74 65 72 73 2e 20 | 0d 54 68 65 20 6f 62 6a |meters. |.The obj|
|00005970| 65 63 74 20 70 61 72 61 | 6d 65 74 65 72 20 69 73 |ect para|meter is|
|00005980| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 61 20 4d | the nam|e of a M|
|00005990| 61 63 69 6e 74 6f 73 68 | 20 69 6e 20 7a 6f 6e 65 |acintosh| in zone|
|000059a0| 2e 20 54 68 65 20 74 79 | 70 65 20 66 69 65 6c 64 |. The ty|pe field|
|000059b0| 20 73 68 6f 75 6c 64 20 | 0d 75 73 75 61 6c 6c 79 | should |.usually|
|000059c0| 20 62 65 20 73 65 74 20 | 74 6f 20 50 50 43 54 6f | be set |to PPCTo|
|000059d0| 6f 6c 62 6f 78 2e 0d 0d | 0d 61 65 69 6e 74 65 72 |olbox...|.aeinter|
|000059e0| 61 63 74 0d 0d 54 68 69 | 73 20 63 6f 6d 6d 61 6e |act..Thi|s comman|
|000059f0| 64 20 69 73 20 75 73 65 | 64 20 77 68 65 6e 20 79 |d is use|d when y|
|00005a00| 6f 75 20 61 72 65 20 72 | 75 6e 6e 69 6e 67 20 61 |ou are r|unning a|
|00005a10| 20 73 63 72 69 70 74 20 | 76 69 61 20 41 70 70 6c | script |via Appl|
|00005a20| 65 20 45 76 65 6e 74 2c | 20 61 6e 64 20 6e 65 65 |e Event,| and nee|
|00005a30| 64 20 0d 75 73 65 72 20 | 69 6e 74 65 72 61 63 74 |d .user |interact|
|00005a40| 69 6f 6e 2e 20 49 66 20 | 79 6f 75 20 64 6f 20 6e |ion. If |you do n|
|00005a50| 6f 74 20 63 61 6c 6c 20 | 74 68 69 73 2c 20 75 73 |ot call |this, us|
|00005a60| 65 72 20 69 6e 74 65 72 | 61 63 74 69 6f 6e 20 6d |er inter|action m|
|00005a70| 61 79 20 62 65 68 61 76 | 65 20 69 6d 70 72 6f 70 |ay behav|e improp|
|00005a80| 65 72 6c 79 2e 0d 0d 0d | 2a 2a 2a 20 41 50 50 45 |erly....|*** APPE|
|00005a90| 4e 44 49 58 20 20 2d 20 | 20 41 20 2a 2a 2a 0d 0d |NDIX  - | A ***..|
|00005aa0| 2a 4e 4f 54 45 2a 0d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |*NOTE*.=|========|
|00005ab0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005ac0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005ad0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005ae0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005af0| 3d 3d 3d 3d 0d 49 20 68 | 61 76 65 20 6e 6f 74 20 |====.I h|ave not |
|00005b00| 64 6f 6e 65 20 65 78 74 | 65 6e 73 69 76 65 20 74 |done ext|ensive t|
|00005b10| 65 73 74 69 6e 67 20 6f | 66 20 41 6c 70 68 61 20 |esting o|f Alpha |
|00005b20| 77 69 74 68 20 58 54 43 | 4c 73 2e 20 48 6f 77 65 |with XTC|Ls. Howe|
|00005b30| 76 65 72 2c 20 61 6c 6c | 20 74 68 6f 73 65 20 0d |ver, all| those .|
|00005b40| 74 68 61 74 20 49 20 64 | 69 64 20 74 72 79 20 77 |that I d|id try w|
|00005b50| 6f 72 6b 65 64 20 63 6f | 72 72 65 63 74 6c 79 2e |orked co|rrectly.|
|00005b60| 20 46 6f 72 20 6d 6f 72 | 65 20 69 6e 66 6f 72 6d | For mor|e inform|
|00005b70| 61 74 69 6f 6e 20 6f 6e | 20 58 54 43 4c 73 2c 20 |ation on| XTCLs, |
|00005b80| 61 73 20 77 65 6c 6c 20 | 61 73 20 0d 73 61 6d 70 |as well |as .samp|
|00005b90| 6c 65 20 63 6f 64 65 2c | 20 64 6f 77 6e 6c 6f 61 |le code,| downloa|
|00005ba0| 64 20 74 68 65 20 66 69 | 6c 65 20 58 54 43 4c 2e |d the fi|le XTCL.|
|00005bb0| 63 70 74 2e 62 69 6e 20 | 66 72 6f 6d 20 74 68 65 |cpt.bin |from the|
|00005bc0| 20 41 6c 70 68 61 20 61 | 72 63 68 69 76 65 20 73 | Alpha a|rchive s|
|00005bd0| 69 74 65 2c 20 0d 63 73 | 2e 72 69 63 65 2e 65 64 |ite, .cs|.rice.ed|
|00005be0| 75 20 69 6e 20 74 68 65 | 20 64 69 72 65 63 74 6f |u in the| directo|
|00005bf0| 72 79 20 70 75 62 6c 69 | 63 2f 41 6c 70 68 61 2e |ry publi|c/Alpha.|
|00005c00| 20 41 64 64 69 74 69 6f | 6e 61 6c 6c 79 2c 20 74 | Additio|nally, t|
|00005c10| 68 69 73 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |his info|rmation |
|00005c20| 0d 63 61 6e 20 62 65 20 | 6f 62 74 61 69 6e 65 64 |.can be |obtained|
|00005c30| 20 77 69 74 68 20 74 68 | 65 20 72 65 73 74 20 6f | with th|e rest o|
|00005c40| 66 20 74 68 65 20 74 69 | 63 6b 6c 65 20 64 69 73 |f the ti|ckle dis|
|00005c50| 74 72 69 62 75 74 69 6f | 6e 20 66 72 6f 6d 20 66 |tributio|n from f|
|00005c60| 74 70 2e 6d 73 65 6e 2e | 63 6f 6d 20 0d 69 6e 20 |tp.msen.|com .in |
|00005c70| 74 68 65 20 64 69 72 65 | 63 74 6f 72 79 20 22 70 |the dire|ctory "p|
|00005c80| 75 62 2f 76 65 6e 64 6f | 72 2f 69 63 65 22 2e 20 |ub/vendo|r/ice". |
|00005c90| 0d 09 09 09 09 09 09 09 | 09 09 09 09 09 2d 2d 20 |........|.....-- |
|00005ca0| 70 65 74 65 0d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |pete.===|========|
|00005cb0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005cc0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005cd0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005ce0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005cf0| 3d 3d 0d 0d 54 68 65 20 | 74 63 6c 20 65 78 74 65 |==..The |tcl exte|
|00005d00| 72 6e 61 6c 20 63 6f 6d | 6d 61 6e 64 20 69 6e 74 |rnal com|mand int|
|00005d10| 65 72 66 61 63 65 20 69 | 73 20 73 69 6d 69 6c 61 |erface i|s simila|
|00005d20| 72 20 74 6f 20 74 68 65 | 20 48 79 70 65 72 43 61 |r to the| HyperCa|
|00005d30| 72 64 20 65 78 74 65 72 | 6e 61 6c 20 0d 63 6f 6d |rd exter|nal .com|
|00005d40| 6d 61 6e 64 20 69 6e 74 | 65 72 66 61 63 65 2e 20 |mand int|erface. |
|00005d50| 59 6f 75 72 20 63 6f 64 | 65 20 69 73 20 61 20 73 |Your cod|e is a s|
|00005d60| 74 61 6e 64 20 61 6c 6f | 6e 65 20 6d 6f 64 75 6c |tand alo|ne modul|
|00005d70| 65 20 74 68 61 74 20 65 | 78 69 73 74 73 20 61 73 |e that e|xists as|
|00005d80| 20 61 20 0d 72 65 73 6f | 75 72 63 65 20 69 6e 20 | a .reso|urce in |
|00005d90| 74 68 65 20 63 6f 6d 6d | 6f 6e 20 58 54 43 4c 20 |the comm|on XTCL |
|00005da0| 46 69 6c 65 20 6f 72 20 | 69 6e 20 61 20 66 69 6c |File or |in a fil|
|00005db0| 65 20 62 79 20 69 74 73 | 65 6c 66 2e 0d 0d 54 68 |e by its|elf...Th|
|00005dc0| 65 20 61 64 76 61 6e 74 | 61 67 65 20 6f 66 20 68 |e advant|age of h|
|00005dd0| 61 76 69 6e 67 20 79 6f | 75 72 20 58 54 43 4c 20 |aving yo|ur XTCL |
|00005de0| 69 6e 20 61 20 73 65 70 | 61 72 61 74 65 20 66 69 |in a sep|arate fi|
|00005df0| 6c 65 20 69 73 20 74 68 | 65 20 61 62 69 6c 69 74 |le is th|e abilit|
|00005e00| 79 20 74 6f 20 68 61 76 | 65 20 0d 61 63 63 65 73 |y to hav|e .acces|
|00005e10| 73 20 74 6f 20 79 6f 75 | 72 20 6f 77 6e 20 73 65 |s to you|r own se|
|00005e20| 74 20 6f 66 20 72 65 73 | 6f 75 72 63 65 73 20 74 |t of res|ources t|
|00005e30| 68 61 74 20 61 72 65 20 | 61 6c 77 61 79 73 20 63 |hat are |always c|
|00005e40| 61 72 72 69 65 64 20 61 | 72 6f 75 6e 64 20 77 69 |arried a|round wi|
|00005e50| 74 68 20 74 68 65 20 0d | 58 54 43 4c 2e 20 54 68 |th the .|XTCL. Th|
|00005e60| 65 20 64 69 73 61 64 76 | 61 6e 74 61 67 65 20 69 |e disadv|antage i|
|00005e70| 73 20 74 68 65 20 63 6f | 73 74 20 6f 66 20 6f 70 |s the co|st of op|
|00005e80| 65 6e 69 6e 67 20 61 6e | 64 20 63 6c 6f 73 65 20 |ening an|d close |
|00005e90| 74 68 65 20 58 54 43 4c | 27 73 20 66 69 6c 65 20 |the XTCL|'s file |
|00005ea0| 0d 65 76 65 72 79 20 74 | 69 6d 65 20 69 74 20 69 |.every t|ime it i|
|00005eb0| 73 20 65 78 65 63 75 74 | 65 64 2e 20 41 20 66 75 |s execut|ed. A fu|
|00005ec0| 74 75 72 65 20 72 65 6c | 65 61 73 65 20 6f 66 20 |ture rel|ease of |
|00005ed0| 74 69 63 6b 6c 65 20 77 | 69 6c 6c 20 63 61 63 68 |tickle w|ill cach|
|00005ee0| 65 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 0d 6f |e the cu|rrent .o|
|00005ef0| 70 65 6e 20 58 54 43 4c | 20 72 65 73 6f 75 72 63 |pen XTCL| resourc|
|00005f00| 65 2c 20 61 73 20 77 65 | 6c 6c 20 61 73 20 74 68 |e, as we|ll as th|
|00005f10| 65 20 6f 70 65 6e 20 72 | 65 73 6f 75 72 63 65 20 |e open r|esource |
|00005f20| 66 69 6c 65 2c 20 6d 61 | 6b 69 6e 67 20 72 65 70 |file, ma|king rep|
|00005f30| 65 61 74 65 64 20 0d 63 | 61 6c 6c 73 20 74 6f 20 |eated .c|alls to |
|00005f40| 74 68 65 20 58 54 43 4c | 20 76 65 72 79 20 66 61 |the XTCL| very fa|
|00005f50| 73 74 2e 0d 0d 57 68 65 | 6e 20 74 69 63 6b 6c 65 |st...Whe|n tickle|
|00005f60| 20 69 73 20 61 73 6b 65 | 64 20 74 6f 20 65 78 65 | is aske|d to exe|
|00005f70| 63 75 74 65 20 74 68 65 | 20 65 78 74 65 72 6e 61 |cute the| externa|
|00005f80| 6c 20 63 6f 6d 6d 61 6e | 64 2c 20 69 74 20 6c 6f |l comman|d, it lo|
|00005f90| 61 64 73 20 74 68 65 20 | 72 65 73 6f 75 72 63 65 |ads the |resource|
|00005fa0| 20 0d 66 72 6f 6d 20 74 | 68 65 20 28 31 29 20 61 | .from t|he (1) a|
|00005fb0| 70 70 6c 69 63 61 74 69 | 6f 6e 20 72 65 73 6f 75 |pplicati|on resou|
|00005fc0| 72 63 65 20 66 6f 72 6b | 2c 20 28 32 29 20 74 68 |rce fork|, (2) th|
|00005fd0| 65 20 58 54 43 4c 20 46 | 69 6c 65 20 72 65 73 6f |e XTCL F|ile reso|
|00005fe0| 75 72 63 65 20 66 6f 72 | 6b 2c 20 6f 72 20 28 33 |urce for|k, or (3|
|00005ff0| 29 20 0d 74 68 65 20 72 | 65 73 6f 75 72 63 65 20 |) .the r|esource |
|00006000| 66 6f 72 6b 20 6f 66 20 | 74 68 65 20 6f 70 74 69 |fork of |the opti|
|00006010| 6f 6e 61 6c 20 66 69 6c | 65 20 70 61 72 61 6d 65 |onal fil|e parame|
|00006020| 74 65 72 2e 20 54 68 65 | 20 72 65 73 6f 75 72 63 |ter. The| resourc|
|00006030| 65 20 69 73 20 6c 6f 63 | 6b 65 64 20 0d 64 6f 77 |e is loc|ked .dow|
|00006040| 6e 20 69 6e 20 6d 65 6d | 6f 72 79 2c 20 61 6e 64 |n in mem|ory, and|
|00006050| 20 63 61 6c 6c 65 64 20 | 61 73 20 61 20 43 20 66 | called |as a C f|
|00006060| 75 6e 63 74 69 6f 6e 2e | 20 54 68 65 20 65 78 74 |unction.| The ext|
|00006070| 65 72 6e 61 6c 20 63 6f | 6d 6d 61 6e 64 27 73 20 |ernal co|mmand's |
|00006080| 43 20 0d 63 6f 64 65 20 | 73 68 6f 75 6c 64 20 62 |C .code |should b|
|00006090| 65 67 69 6e 20 61 73 3a | 0d 0d 76 6f 69 64 0d 58 |egin as:|..void.X|
|000060a0| 54 43 4c 45 6e 74 72 79 | 28 61 72 67 63 2c 20 61 |TCLEntry|(argc, a|
|000060b0| 72 67 76 2c 20 78 70 62 | 29 0d 69 6e 74 09 09 09 |rgv, xpb|).int...|
|000060c0| 61 72 67 63 3b 0d 63 68 | 61 72 09 09 09 2a 2a 61 |argc;.ch|ar...**a|
|000060d0| 72 67 76 3b 0d 58 54 43 | 4c 50 61 72 6d 42 6c 6b |rgv;.XTC|LParmBlk|
|000060e0| 09 09 2a 78 70 62 3b 0d | 0d 54 68 65 20 70 61 72 |..*xpb;.|.The par|
|000060f0| 61 6d 65 74 65 72 73 20 | 61 72 65 20 73 69 6d 69 |ameters |are simi|
|00006100| 6c 61 72 20 74 6f 20 77 | 68 61 74 20 79 6f 75 20 |lar to w|hat you |
|00006110| 77 6f 75 6c 64 20 65 78 | 70 65 63 74 20 61 6e 79 |would ex|pect any|
|00006120| 20 43 20 74 79 70 65 20 | 70 72 6f 67 72 61 6d 20 | C type |program |
|00006130| 0d 74 6f 20 74 61 6b 65 | 2c 20 65 78 63 65 70 74 |.to take|, except|
|00006140| 20 66 6f 72 20 74 68 65 | 20 78 70 62 20 70 61 72 | for the| xpb par|
|00006150| 61 6d 65 74 65 72 20 62 | 6c 6f 63 6b 2e 20 54 68 |ameter b|lock. Th|
|00006160| 69 73 20 70 61 72 61 6d | 65 74 65 72 20 62 6c 6f |is param|eter blo|
|00006170| 63 6b 20 69 73 20 79 6f | 75 72 20 0d 6c 69 6e 6b |ck is yo|ur .link|
|00006180| 20 62 61 63 6b 20 69 6e | 74 6f 20 74 69 63 6b 6c | back in|to tickl|
|00006190| 65 2e 20 48 65 72 65 20 | 69 73 20 74 68 65 20 73 |e. Here |is the s|
|000061a0| 74 72 75 63 74 75 72 65 | 3a 0d 0d 74 79 70 65 64 |tructure|:..typed|
|000061b0| 65 66 20 73 74 72 75 63 | 74 20 7b 0d 20 2d 3e 09 |ef struc|t {. ->.|
|000061c0| 6c 6f 6e 67 09 76 65 72 | 73 69 6f 6e 3b 0d 3c 2d |long.ver|sion;.<-|
|000061d0| 3e 09 6c 6f 6e 67 09 72 | 65 73 75 6c 74 3b 0d 3c |>.long.r|esult;.<|
|000061e0| 2d 3e 09 48 61 6e 64 6c | 65 09 72 65 73 75 6c 74 |->.Handl|e.result|
|000061f0| 48 3b 0d 20 2d 3e 09 73 | 68 6f 72 74 09 63 6d 64 |H;. ->.s|hort.cmd|
|00006200| 52 65 66 4e 75 6d 3b 0d | 20 2d 3e 09 48 61 6e 64 |RefNum;.| ->.Hand|
|00006210| 6c 65 09 63 6d 64 48 61 | 6e 64 6c 65 3b 0d 20 2d |le.cmdHa|ndle;. -|
|00006220| 3e 09 54 63 6c 5f 49 6e | 74 65 72 70 09 2a 69 6e |>.Tcl_In|terp.*in|
|00006230| 74 65 72 70 3b 0d 20 2d | 3e 09 69 6e 74 09 28 2a |terp;. -|>.int.(*|
|00006240| 65 76 61 6c 29 28 29 3b | 0d 20 2d 3e 09 4d 6f 64 |eval)();|. ->.Mod|
|00006250| 61 6c 46 69 6c 74 65 72 | 50 72 6f 63 50 74 72 09 |alFilter|ProcPtr.|
|00006260| 6d 6f 64 61 6c 70 72 6f | 63 3b 0d 20 2d 09 6c 6f |modalpro|c;. -.lo|
|00006270| 6e 67 09 72 65 73 65 72 | 76 65 64 3b 0d 09 7d 20 |ng.reser|ved;..} |
|00006280| 58 54 43 4c 50 61 72 6d | 42 6c 6b 2c 20 2a 58 54 |XTCLParm|Blk, *XT|
|00006290| 43 4c 50 42 50 74 72 3b | 0d 0d 54 68 65 20 76 65 |CLPBPtr;|..The ve|
|000062a0| 72 73 69 6f 6e 20 66 69 | 65 6c 64 20 69 73 20 70 |rsion fi|eld is p|
|000062b0| 61 73 73 65 64 20 69 6e | 20 74 6f 20 69 6e 64 69 |assed in| to indi|
|000062c0| 63 61 74 65 20 74 6f 20 | 74 68 65 20 63 6f 6d 6d |cate to |the comm|
|000062d0| 61 6e 64 20 77 68 61 74 | 20 6c 65 76 65 6c 20 6f |and what| level o|
|000062e0| 66 20 0d 66 75 6e 63 74 | 69 6f 6e 61 6c 69 74 79 |f .funct|ionality|
|000062f0| 20 74 68 65 20 74 63 6c | 20 63 61 6c 6c 62 61 63 | the tcl| callbac|
|00006300| 6b 20 66 75 6e 63 74 69 | 6f 6e 20 73 75 70 70 6f |k functi|on suppo|
|00006310| 72 74 73 2c 20 61 73 20 | 77 65 6c 6c 20 61 73 20 |rts, as |well as |
|00006320| 69 6e 64 69 63 61 74 65 | 20 74 68 65 20 0d 76 65 |indicate| the .ve|
|00006330| 72 73 69 6f 6e 20 6f 66 | 20 74 68 65 20 70 61 72 |rsion of| the par|
|00006340| 61 6d 65 74 65 72 20 62 | 6c 6f 63 6b 20 64 61 74 |ameter b|lock dat|
|00006350| 61 20 73 74 72 75 63 74 | 75 72 65 2e 20 54 68 65 |a struct|ure. The|
|00006360| 20 63 75 72 72 65 6e 74 | 20 76 65 72 73 69 6f 6e | current| version|
|00006370| 20 6e 75 6d 62 65 72 20 | 0d 6f 66 20 64 65 66 69 | number |.of defi|
|00006380| 6e 65 64 20 62 79 20 58 | 54 43 4c 5f 43 42 5f 56 |ned by X|TCL_CB_V|
|00006390| 45 52 53 49 4f 4e 20 69 | 6e 20 74 68 65 20 68 65 |ERSION i|n the he|
|000063a0| 61 64 65 72 20 66 69 6c | 65 20 58 54 43 4c 2e 68 |ader fil|e XTCL.h|
|000063b0| 20 61 6e 64 20 69 73 20 | 63 75 72 72 65 6e 74 6c | and is |currentl|
|000063c0| 79 20 0d 30 78 30 30 30 | 31 30 30 30 31 2e 0d 0d |y .0x000|10001...|
|000063d0| 54 68 65 20 72 65 73 75 | 6c 74 20 66 69 65 6c 64 |The resu|lt field|
|000063e0| 20 69 73 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 | is retu|rned by |
|000063f0| 74 68 65 20 65 78 74 65 | 72 6e 61 6c 20 63 6f 6d |the exte|rnal com|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.